Post

Great docs = Great developer experience ✅ Want to write clearer, more effective docs? We've put together tips on structure and tone—with plenty of real-world examples for reference. 📝 Check out the developer's guide. ⬇️

github.blogDocumentation done right: A developer’s guideLearn why and how you should write docs for your project with the Diátaxis framework.

26/5/25, 7:27 pm6 reposts72 likes

Skyward Bluze

@swbze.bsky.social

26 May 2025

Absolutely true. Good documentation is key for success.

Jan Aagaard

@janaagaard.com

26 May 2025

Am I the only one who really hates the Diátaxis framework? I find it such a mess to have these four categories at the top level because my experience is that documents will often contain chapters that fall into different categories.