|
|
|
|
|
by infogulch
1710 days ago
|
|
I like linking to this site [0], the "The Grand Unified Theory of Documentation" that describes four categories of documentation that fill out a 2D space of potential docs value: the practical steps <-> theoretical knowledge dimension, and the useful when studying <-> useful when working dimension. * Tutorials - Learning-oriented - (practical/studying)
* How To Guides - Problem-oriented - (practical/working)
* Explanations - Understanding-oriented - (theoretical/studying)
* Reference - Information-oriented - (theoretical/working)
It passed through HN ~9 months ago [1], where
kaycebasques stated, "I think the key breakthrough with Divio's framework is getting authors to think about docs in terms of desired goals and outcomes: learning-oriented, problem-oriented, etc."[0]: https://documentation.divio.com [1]: https://news.ycombinator.com/item?id=26002656 |
|