Hacker News new | ask | show | jobs
by bombcar 99 days ago
There's three kinds of documentation:

* Wiki-style "HOWTO"-based that helps you solve a particular problem (Arch and Gentoo wikis showcase this style well)

* Reference documentation that reminds you how you solved a problem (man pages are great examples here)

* Comprehensive documentation that truly documents the system, but can be a bit more obscure if you're not reading it "cover to cover" - textbook style (This is the older "original" software documentation type, which the BSD docs are an example of)