Improve documentation

Besides `doc/Makefile`, all other changes are to docstrings only.