docs: pre-release improvements

* Improves PEP8 and PEP257 of all files.

* Integrates documentation on a single page.

* Adds tests for strict Sphinx documentation build and PEP257.

Signed-off-by: Jiri Kuncar <jiri.kuncar@cern.ch>