13 Things People Hate about Your Open Source Docs by Andy Lester.
From the post:
1. Lacking a good README or introduction
2. Docs not available online
3. Docs only available online
4. Docs not installed with the package
5. Lack of screenshots
6. Lack of realistic examples
7. Inadequate links and references
8. Forgetting the new user
9. Not listening to the users
10. Not accepting user input
11. No way to see what the software does without installing it
12. Relying on technology to do your writing
13. Arrogance and hostility toward the user
See Andy’s post for the details and suggestions on ways to improve.
Definitely worth a close read!