[area51org]

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]

I think the article is talking about internal documentation rather that user-facing documentation.

[webmaven]

> 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.