From b9e34e04a20d5c38b81b67bf050e3d3898988f42 Mon Sep 17 00:00:00 2001
From: Daniel Chao <daniel.h.chao@gmail.com>
Date: Tue, 30 Jan 2024 13:53:13 -0800
Subject: [PATCH] Created Version schemes (markdown)

---
 Version-schemes.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 Version-schemes.md

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/...