see #678
make it possible to compile documentation via sphinx - main change is to use RST instead of MarkDown for most files.