Rework documentation files

The previous documentation files generated tons of warnings and errors when compiled with sphinx-build.

This here is a clean start, with only a minimal set of files, the rest generated dynamically from the docstrings in the source files when calling sphinx-build.

In the future, one might to better organize the index of the documentation, and put additional chapters.