Improved docs

A number of changes to the docs and docstrings, generally skimming through and cleaning up, modernizing, bringing up-to-date with the code, etc.