Hacker News new | ask | show | jobs
by Arch-TK 101 days ago
FreeBSD and OpenBSD docs are great, but let's not say they're the pinnacle of docs. I like them a lot more than docs for the average Linux distribution. They're even more polished than Arch Linux wiki. But they still have room for improvement. And improving the Arch wiki is easier in my experience.
1 comments

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)