versioning doc

README.md

@@ -29,6 +29,20 @@ Develop & serve on [localhost:8000](http://localhost:8000/):
 docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material
 ```
 
+## Publish & Versioning
+
+The documentation of this repo is published on [GitHub Pages](https://pages.github.com/). It is set
+up to support multiple versions of the documentation seperately. It uses
+[mike](https://github.com/jimporter/mike) to do so, following the documetation of mkdocs: [Seting up
+versioning](https://squidfunk.github.io/mkdocs-material/setup/setting-up-versioning/). This means:
+
+- the `main` branch is published under 'version' `dev`
+- every branch starting with `v` is published under the branch name; e.g. branch `v0.90` is
+  published as such
+- there is a workflow available to [set the default
+  version](https://github.com/kadaster-labs/lock-unlock-docs/actions/workflows/set-default.yml) to
+  show; this takes a manual input ( :warning: be sure to enter a matching name)
+
 ## License
 
 Om hergebruik en doorontwikkeling maximaal mogelijk te maken, is dit project gelicenseerd onder