3 ms·
It's all and none of these things. The single biggest problem with documentation is that it is written by people who are not imagining themselves as the USERS o
by area51org 6y ago
It's all and none of these things. The single biggest problem with documentation is that it is written by people who are not imagining themselves as the USERS of the software. Typical docs are descriptions of the software, like you'd describe an elephant: here's the trunk, these are what the feet look like. Want to work with an elephant? You're on your own.
- ebiester 6y agoI think the article is talking about internal documentation rather that user-facing documentation.
- webmaven 6y ago> I think the article is talking about internal documentation rather that user-facing documentation. I'm not sure why you have that impression, both of the exemplars are user-facing.