docs: add mkdocs, update links, add architecture documentation

.gitignore

@@ -0,0 +1,24 @@
+# MkDocs build output
+docs/site/
+docs/.mkdocs_cache/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+venv/
+env/
+ENV/
+
+# Go (if not already present)
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+*.test
+*.out
+go.work
+