I think one of the problems is that we all know good documentation when we see it but the definition of good documentation is elusive.

The art of writing documentation is an unrecognised skill.  The skill is in boiling something complicated down into an easily digested piece of information. If you have the skill then your output will be so simple as to underrepresent the effort required to write it