docs are looking good now. readthedocs still doesn't import our python
code though.  Quite a few fixes required in the docs.