← Back to context

Comment by losvedir

2 years ago

Ooooh! I've seen this organization before, but didn't realize it was a thing, or had a name. I don't personally like it, as I get confused about where to go. When I saw "tutorials" and "how-to guides", for example, I had thought those were roughly the same thing and didn't know which to click. And seeing "Explanation" separately was even worse because why would I want a guide or tutorial without explanations??

I get "reference" as a separate section, maybe, though to my mind the best docs are built around reference with explanations and little code samples and how-tos mixed in as necessary, and maybe a single "Getting Started" guide for installation and configuration and stuff like that.