Hacker News new | ask | show | jobs
by thu2111 1931 days ago
This is definitely a part of the problem. Docs require a target audience but the brutal reality of writing for people in computing is that there is no bar and you can't assume anything at all about your readers, but if you dumb things down too much the skilled users who are more likely to appreciate docs in the first place will get exhausted and stop reading.

I tend to see docs and interactive QA as complimentary. If you can answer questions by linking to documentation it saves a lot of time.