General Notes
-
Bad documentation is usually social problem, not technical one.
-
Documentation is often read by managers who choose products. Writers often forget that they are writing not only for technical audience, but their documentation is also like a shop window. Now, documentation is read not only by readers who already signed in, but also by potential users. Lack of documentation is also marketing problem.