add mkdocs features and clean up
This MR cleans up the documentation and adds features to mkdocs
to finally be able to display tables in toggle menus.
Further, it fixes the part in the CI which is responsible for creating and deploying the documentation.