I welcome criticism on our written documentation, since most words are mine -- technical documentation is hard to get right. It's a balance of writing for non-technical users, and links to additional content for those who want a bit more detail.
If you can share you're document we can help you out. We're flying blind.