diff --git a/Version-schemes.md b/Version-schemes.md
new file mode 100644
index 0000000..7eac8ce
--- /dev/null
+++ b/Version-schemes.md
@@ -0,0 +1,15 @@
+We distinguish between *release* versions built from tags and *dev* versions built from tip of `main` branch.
+
+== preferred version scheme (semver)
+release version         : 0.25.0
+dev version (unique)    : 0.25.0-dev+6bd8216
+dev version (non-unique): 0.25.0-dev
+
+== version scheme for maven (gradle build's `project.version` is set to this)
+release version         : 0.25.0
+dev version (non-unique): 0.25.0-SNAPSHOT
+
+== version scheme for (doc) urls
+release version               : .../0.25.0/...
+last published release version: .../current/...
+last published dev version    : .../latest/...