Enhance documentation

- upgraded mkdocs and dependencise (+ add mermaid)
- linted markdown
- add more details

doc/requirements.txt

@@ -1,7 +1,7 @@
-mkdocs>=1.5.3
-Jinja2>=3.1.3
-MarkupSafe>=2.1.5
-pymdown-extensions>=10.7.1
-mkdocs-material>=9.5.17
-mkdocs-material-extensions>=1.3.1
-mkdocs-plugin-inline-svg-mod>=0.0.1
+mkdocs==1.*
+Jinja2==3.*
+MarkupSafe==3.*
+pymdown-extensions==10.*
+mkdocs-material==9.*
+mkdocs-material-extensions==1.*
+mkdocs-plugin-inline-svg-mod