Diátaxis: A systematic framework for technical documentation authoring

diataxis.fr

188 points·codazoda··7 comments

Original discussion[0] on "High-documentation, low-meeting culture" from yesterday, where this was linked to by u/ebiester in one of the top comments.

(also, great read)

[0]: https://news.ycombinator.com/item?id=33707022

Thanks! Also related:

Diátaxis: systematic framework for technical documentation authoring - https://news.ycombinator.com/item?id=33020045 - Sept 2022 (5 comments)

Unified theory of documentation systems - https://news.ycombinator.com/item?id=31874436 - June 2022 (14 comments)

The Grand Unified Theory of Documentation - https://news.ycombinator.com/item?id=26824743 - April 2021 (57 comments)

A Framework for Writing Better Documentation - https://news.ycombinator.com/item?id=26002656 - Feb 2021 (76 comments)

Four kinds of documentation - https://news.ycombinator.com/item?id=21289832 - Oct 2019 (199 comments)

What nobody tells you about documentation - https://news.ycombinator.com/item?id=15869296 - Dec 2017 (5 comments)

Perhaps it's a product of French culture, but because Gorgonia[0] has a number of French contributors, this was actually the way we structured our documentation.

But this is the first time I've heard of the name of the framework.

[0]: https://gorgonia.org

https://documentation.divio.com/ seems to be talking about the same system.

The original author left divio and maintains diataxis now.

https://news.ycombinator.com/item?id=33711160

Thanks! added to the list at https://news.ycombinator.com/item?id=33725911.

Yes!

Reply on news.ycombinator.com