Documentation should be prepared by qualified specialists. The key to good documentation is to correctly identify the problem to be solved, and hence to specify an appropriate solution. The nature and extent of the work must then be clearly conveyed to those who will do it.
This information sheet discusses what and how to document.