Hacker News new | ask | show | jobs
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