4 ms·
Love that you are paying docs more respect by giving people a leg up on how to write docs right. This isn't talked about enough as far as I know. I will offer
by kbos87 3y ago
Love that you are paying docs more respect by giving people a leg up on how to write docs right. This isn't talked about enough as far as I know.
I will offer a point on the headline... I agree with you that docs deserve more respect, but I also think that you and I (and likely many HN readers) are a biased sample. The average user (of a non-technical product) spends a lot less time reading docs than we all probably think they do.
Docs are respected proportionally to the amount of value that can be ascribed to them. I think that value is unfortunately undercounted, but people seem to be consistently valuing "docs" in the $ resourced against them and the attention paid.
- ramijames 3y agoIt's really dependant on the industry. Docs for a retail audience get low usage. Docs for developer tooling get high usage. It's a whole spectrum. As for the title, well, it's a draw for the reader and needs to be spicy. Really when I wrote it, I meant from an organizational or project perspective.