Comments, Assertions and Unit Tests
See "Commenting the Code".
This posting tickled my fancy because it addressed the central issue of "what requires comments outside Python docstrings". All functions, classes, modules and packages require docstrings. That's clear. But which lines of code require additional documentation?
We use Sphinx, so we make extensive use of docstrings …
more ...