docs: test documentation build

* Adds Sphinx build to test file to ensure documentation can be built.

* Fixes documentation build problems.

Signed-off-by: Lars Holm Nielsen <lars.holm.nielsen@cern.ch>

<!---
@huboard:{"order":4.0,"milestone_order":85,"custom_state":""}
-->