I'm working on writing documentation and getting a lot of insight from diataxis.fr
shoutout to the default Starlight docs from @astro.build for surfacing this link
shoutout to the default Starlight docs from @astro.build for surfacing this link
Diátaxis
Diátaxis is a widely-adopted, pragmatic and systematic approach to thinking about and creating documentation.
diataxis.fr
June 5, 2026 at 7:38 PM
I'm working on writing documentation and getting a lot of insight from diataxis.fr
shoutout to the default Starlight docs from @astro.build for surfacing this link
shoutout to the default Starlight docs from @astro.build for surfacing this link
Diátaxis is an amazing resource that I recommend to everyone writing documentation or tutorials: diataxis.fr
I find myself returning to it every few weeks, and each time I learn something new.
#documentation
I find myself returning to it every few weeks, and each time I learn something new.
#documentation
Diátaxis
Diátaxis is a widely-adopted, pragmatic and systematic approach to thinking about and creating documentation.
diataxis.fr
November 26, 2025 at 11:54 AM
Diátaxis is an amazing resource that I recommend to everyone writing documentation or tutorials: diataxis.fr
I find myself returning to it every few weeks, and each time I learn something new.
#documentation
I find myself returning to it every few weeks, and each time I learn something new.
#documentation
TIL about Diátaxis. diataxis.fr
There's no shortage of interesting things to learn.
There's no shortage of interesting things to learn.
Diátaxis
Diátaxis is a widely-adopted, pragmatic and systematic approach to thinking about and creating documentation.
diataxis.fr
September 24, 2026 at 3:58 PM
TIL about Diátaxis. diataxis.fr
There's no shortage of interesting things to learn.
There's no shortage of interesting things to learn.
Retrouvez nous en live sur Youtube pour parler de diataxis
www.youtube.com/watch?v=_6S7...
www.youtube.com/watch?v=_6S7...
LCC 320 - LIVE - Diátaxis, la méthode de documentation
YouTube video by lescastcodeurs
www.youtube.com
December 20, 2024 at 11:58 AM
Retrouvez nous en live sur Youtube pour parler de diataxis
www.youtube.com/watch?v=_6S7...
www.youtube.com/watch?v=_6S7...
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. ⬇️
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. ⬇️
Documentation done right: A developer’s guide
Learn why and how you should write docs for your project with the Diátaxis framework.
github.blog
May 26, 2025 at 7:27 PM
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. ⬇️
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. ⬇️
LCC 320 sur YouTube. Diataxis, la méthode de documentation, la méthode de documentation #diataxis #documentation
www.youtube.com/watch?v=3RXA...
www.youtube.com/watch?v=3RXA...
LCC 320 - Diataxis, la méthode de documentation
YouTube video by lescastcodeurs
www.youtube.com
December 21, 2024 at 9:40 AM
LCC 320 sur YouTube. Diataxis, la méthode de documentation, la méthode de documentation #diataxis #documentation
www.youtube.com/watch?v=3RXA...
www.youtube.com/watch?v=3RXA...
Outro efeito colateral é que isso ajuda a AI a ter um contexto melhor.
Para documentar features da aplicação ainda contamos com docs estruturados (diataxis etc)
Para doc técnica, o mais simples funciona melhor.
Para documentar features da aplicação ainda contamos com docs estruturados (diataxis etc)
Para doc técnica, o mais simples funciona melhor.
November 22, 2024 at 12:39 PM
Outro efeito colateral é que isso ajuda a AI a ter um contexto melhor.
Para documentar features da aplicação ainda contamos com docs estruturados (diataxis etc)
Para doc técnica, o mais simples funciona melhor.
Para documentar features da aplicação ainda contamos com docs estruturados (diataxis etc)
Para doc técnica, o mais simples funciona melhor.
Most documentation has a structural problem that exists before any individual piece of writing: nobody has decided what kind of content belongs in the documentation and what each content type is supposed to do.
#diataxis #technicalwriting
stevearrants.substack.com/p/documentat...
#diataxis #technicalwriting
stevearrants.substack.com/p/documentat...
Documentation Frameworks: A Field Guide
Diátaxis is the one to start with, but DITA, minimalism, and others fill the gaps it leaves open.
stevearrants.substack.com
July 31, 2026 at 12:43 PM
Most documentation has a structural problem that exists before any individual piece of writing: nobody has decided what kind of content belongs in the documentation and what each content type is supposed to do.
#diataxis #technicalwriting
stevearrants.substack.com/p/documentat...
#diataxis #technicalwriting
stevearrants.substack.com/p/documentat...
My rambling on Diataxis emmanuelbernard.com/blog/2024/12...
Exploring Diataxis - on structuring documentation
I recently spent some time exploring Diataxis, a documentation framework that promises to make technical documentation not just readable but genuinely useful. You might have heard of Diataxis or you m...
emmanuelbernard.com
December 19, 2024 at 10:08 AM
My rambling on Diataxis emmanuelbernard.com/blog/2024/12...
I just published an article on how I used the Diátaxis framework to create my first programming video. You can check it out here:
damilola-oladele.github.io/posts/diatax...
#documentation #YouTube #technicalwriting
damilola-oladele.github.io/posts/diatax...
#documentation #YouTube #technicalwriting
How I Used the Diataxis Framework to Create My First YouTube Tutorial
Using the Diataxis tutorial approach was about finding a starting point, not perfection.
damilola-oladele.github.io
November 27, 2024 at 4:29 AM
I just published an article on how I used the Diátaxis framework to create my first programming video. You can check it out here:
damilola-oladele.github.io/posts/diatax...
#documentation #YouTube #technicalwriting
damilola-oladele.github.io/posts/diatax...
#documentation #YouTube #technicalwriting
Interested to learn about Diátaxis (diataxis.fr) and how we applied it to our internal developer platform's doc (and more) at @payfiteng.bsky.social ?
I'll be presenting it this afternoon at @breizhcamp.org at 17:35 in Amphi E, and I'll keep you awake for the last talk of the day !
I'll be presenting it this afternoon at @breizhcamp.org at 17:35 in Amphi E, and I'll keep you awake for the last talk of the day !
Diátaxis
Diátaxis is a widely-adopted, pragmatic and systematic approach to thinking about and creating documentation.
diataxis.fr
June 26, 2025 at 10:40 AM
Interested to learn about Diátaxis (diataxis.fr) and how we applied it to our internal developer platform's doc (and more) at @payfiteng.bsky.social ?
I'll be presenting it this afternoon at @breizhcamp.org at 17:35 in Amphi E, and I'll keep you awake for the last talk of the day !
I'll be presenting it this afternoon at @breizhcamp.org at 17:35 in Amphi E, and I'll keep you awake for the last talk of the day !
Umm... if anything NixOS has a lot of "documentation" but not exactly great structure. A big grant should be made to help hammer it through the Diátaxis framework.
July 7, 2025 at 3:08 PM
Umm... if anything NixOS has a lot of "documentation" but not exactly great structure. A big grant should be made to help hammer it through the Diátaxis framework.
yep! and if you want something a bit more formal in that regard, see diataxis.fr
Diátaxis
Diátaxis is a widely-adopted, pragmatic and systematic approach to thinking about and creating documentation.
diataxis.fr
March 11, 2026 at 8:27 PM
yep! and if you want something a bit more formal in that regard, see diataxis.fr
Diátaxis nails something most doc frameworks miss: tutorials aren't guides and how-tos aren't references. The four-quadrant split feels obvious once you see it but most teams still mash everything into "documentation" and wonder why nobody reads it.
August 2, 2026 at 7:35 PM
Diátaxis nails something most doc frameworks miss: tutorials aren't guides and how-tos aren't references. The four-quadrant split feels obvious once you see it but most teams still mash everything into "documentation" and wonder why nobody reads it.
• oauth: OAuth 2.0/2.1 + Fastify integration
• linting: neostandard + ESLint v9 flat config
• documentation: Diátaxis framework
March 12, 2026 at 4:59 PM
• oauth: OAuth 2.0/2.1 + Fastify integration
• linting: neostandard + ESLint v9 flat config
• documentation: Diátaxis framework
Built with Docusaurus and inspired by Diataxis although not strictly bound to it
January 24, 2025 at 2:00 PM
Built with Docusaurus and inspired by Diataxis although not strictly bound to it
Demain à 13h, @glaforge.dev @emmanuelbernard.com et @aheritier.net discutent de Diataxis, le framework de documentation en streaming www.youtube.com/@lescastcode...
lescastcodeurs
Les Cast Codeurs est un podcast en français de, par et pour les développeurs.
Prenez connaissance des dernières nouvelles de la sphère Java et du développement en général. Plongez sur un sujet précis...
www.youtube.com
December 19, 2024 at 11:37 AM
Demain à 13h, @glaforge.dev @emmanuelbernard.com et @aheritier.net discutent de Diataxis, le framework de documentation en streaming www.youtube.com/@lescastcode...
New bibliography entry on the Teaching of the Lord!
For those interested in Byzantine apocrypha, personified days of the week, intestine-burning Eucharists, and the illegality of women combing their hair on Sundays 🪮
www.nasscal.com/e-clavis-chr...
For those interested in Byzantine apocrypha, personified days of the week, intestine-burning Eucharists, and the illegality of women combing their hair on Sundays 🪮
www.nasscal.com/e-clavis-chr...
Teaching of the Lord
Doctrina Domini Standard abbreviation: Teach. Lord Other titles: Didascalia of the Lord, Diataxis of the Holy Apostles Clavis numbers: ECCA 911 Category: Revelation Dialogue Related literature: 2 A…
www.nasscal.com
August 14, 2025 at 9:32 PM
New bibliography entry on the Teaching of the Lord!
For those interested in Byzantine apocrypha, personified days of the week, intestine-burning Eucharists, and the illegality of women combing their hair on Sundays 🪮
www.nasscal.com/e-clavis-chr...
For those interested in Byzantine apocrypha, personified days of the week, intestine-burning Eucharists, and the illegality of women combing their hair on Sundays 🪮
www.nasscal.com/e-clavis-chr...
Someone had shared diataxis.fr at work with me last year. I generally like to think about the audience I'm writing docs for, but this is a great resources for breaking down different types of docs, who they are for, and how you should approach them.
June 5, 2026 at 7:52 PM
Someone had shared diataxis.fr at work with me last year. I generally like to think about the audience I'm writing docs for, but this is a great resources for breaking down different types of docs, who they are for, and how you should approach them.
I’m working on a set of Claude skills to generate clean, human-readable code (and therefore code that can be maintained by humans), and I’m starting to get some pretty nice results.
codeberg.org/k33g/WASIC/s...
By the way, thanks @gouz.dev for introducing me to #Diataxis
codeberg.org/k33g/WASIC/s...
By the way, thanks @gouz.dev for introducing me to #Diataxis
Last_one) { + unsigned char sha1[20]; + struct commit *cmit.
For code review. --zero-commit Output an all-zero hash in each format looks like this.
codeberg.org
August 6, 2026 at 7:20 PM
I’m working on a set of Claude skills to generate clean, human-readable code (and therefore code that can be maintained by humans), and I’m starting to get some pretty nice results.
codeberg.org/k33g/WASIC/s...
By the way, thanks @gouz.dev for introducing me to #Diataxis
codeberg.org/k33g/WASIC/s...
By the way, thanks @gouz.dev for introducing me to #Diataxis
January 8, 2026 at 9:36 PM
Missed our talk today at @touraine.tech about how we reduced @payfiteng.bsky.social AWS bill by 40% in 3 years, with more business and while staying on AWS?
While waiting for the recording, here's the content (in 🇫🇷) I shared: s.42l.fr/touraine-tec...
See you tomorrow, I'll talk about Diátaxis!
While waiting for the recording, here's the content (in 🇫🇷) I shared: s.42l.fr/touraine-tec...
See you tomorrow, I'll talk about Diátaxis!
February 12, 2026 at 3:54 PM
Missed our talk today at @touraine.tech about how we reduced @payfiteng.bsky.social AWS bill by 40% in 3 years, with more business and while staying on AWS?
While waiting for the recording, here's the content (in 🇫🇷) I shared: s.42l.fr/touraine-tec...
See you tomorrow, I'll talk about Diátaxis!
While waiting for the recording, here's the content (in 🇫🇷) I shared: s.42l.fr/touraine-tec...
See you tomorrow, I'll talk about Diátaxis!
✍️ Hygiene skills: unslop, no-comments via the read-only comment-sicko agent, technical-writing (Diátaxis + Google style) and #TypeScript discipline, plus 21 single-lesson principle skills
September 1, 2026 at 10:00 AM
✍️ Hygiene skills: unslop, no-comments via the read-only comment-sicko agent, technical-writing (Diátaxis + Google style) and #TypeScript discipline, plus 21 single-lesson principle skills
