One major problem with documentation is everyone wants it written how they want to read it rather than read it how it was written.

Maybe the solution is to write less and read more.