proof-read the documentation

The documentation must be read by someone other than the authors to ensure a degree of usability and comprehensibility.