Chapter 8. Documentation

Documentation is like sex:when it is good, it is very, very good; and when it is bad, it is better than nothing.

—Dick Brandon

Any nontrivial software development project is likely to be accompanied by various formal or incidental documentation elements. In the following sections we present typical types of documentation you will encounter when examining projects, provide specific examples of how these can help you understand software code, examine some classes of documentation errors, and outline common open-source documentation formats. Take advantage of any documentation you find to supplement your code-reading effort. To paraphrase the aphorism advocating the use of your library: an hour of code reading can save ...

Get Code Reading: The Open Source Perspective now with the O’Reilly learning platform.

O’Reilly members experience live online training, plus books, videos, and digital content from nearly 200 publishers.