Hi,

This patch improves documentation.  There is no change in functionality.
There are 3 categories:

Trivial typos in comments
Checkdoc fixes in docstrings
Addition of header/footer (Commentary section etc), also suggested by
checkdoc

If of interest please install, or otherwise provide suggestions for
further work.