iso27diy-corp/Corpus/Various/Diataxis Documentation System.md

16 lines
601 B
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Diátaxis Documentation System
*Diátaxis*, from the Ancient Greek δῐᾰ́τᾰξῐς: *dia* (“across”) and *taxis* (“arrangement”).
The Diátaxis [website](https://diataxis.fr).
Created by [u/EvilDMP](https://www.reddit.com/user/EvilDMP/).
[Talk](https://youtube.com/watch?v=t4vKPhjcMZg) about Diataxis by Daniele Procida at PyCon
Example of Diataxis: [Gatsby](https://www.gatsbyjs.com/docs/)
![](Diataxis-categories.png)
'Explanation' is often labeled 'discussion' instead in the sense of exploring a topic's implications and applications.
![](Diataxis-infographic.png)