Ingo on documentation:
Technical writing is a form of communication which takes a certain degree of sophistication. Especially when you actually expect someone to read it.
Good technical documentation is hard to produce. By the same token, good technical documentation is hard to come by.