Also, adapt some module docstrings to conform with RST
make it possible to compile documentation via sphinx - main change is to use RST instead of MarkDown for most files.