diff --git a/README.md b/README.md
index b704e2e..8bfa471 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,8 @@ This package connects the [bfabric](https://fgcz-bfabric.uzh.ch/bfabric/) system
 The [bfabricShiny](https://github.com/cpanse/bfabricShiny) R package is an extension and provides code snippets and sample implementation for a seamless R shiny bfabric integration.
 For more advanced users the *bfabricPy* package also provides a powerful query interface on the command-line though using the provided scripts.
 
+You can find the up-to-date documentation at [https://fgcz.github.io/bfabricPy](https://fgcz.github.io/bfabricPy).
+
 ## CheatSheet
 
 ### Read
diff --git a/docs/contribute.md b/docs/contribute.md
index 48803fc..f692906 100644
--- a/docs/contribute.md
+++ b/docs/contribute.md
@@ -17,3 +17,15 @@ With `nox` and `uv` installed, it is as simple as running `nox` in the project r
 ## Integration tests
 
 Note that integration tests have been moved to a separate repository. Please contact us if you are interested.
+
+## Documentation
+
+We currently do not have a versioning solution for the documentation, but we can add that later once it is more mature.
+
+```bash
+# To preview while you write it
+mkdocs serve
+
+# To publish after changes
+mkdocs gh-deploy
+```
diff --git a/pyproject.toml b/pyproject.toml
index 0d8b762..015b6e1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -42,7 +42,8 @@ dev = [
     "pytest-mock",
     "logot",
     "nox",
-    "uv"
+    "uv",
+    "mkdocs"
 ]
 
 [project.urls]