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.