From 7803d6efb95c0eebf94783f960ae2623b8e2e20f Mon Sep 17 00:00:00 2001
From: umarcor <unai.martinezcorral@ehu.eus>
Date: Wed, 1 Dec 2021 00:11:11 +0100
Subject: [PATCH] add DEVELOPMENT.md

---
 DEVELOPMENT.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 DEVELOPMENT.md

diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
new file mode 100644
index 0000000..067df7f
--- /dev/null
+++ b/DEVELOPMENT.md
@@ -0,0 +1,22 @@
+# Development
+
+## Tagging/versioning
+
+See context in [#5](https://github.com/pyTooling/Actions/issues/5).
+
+Tag new releases in the `main` branch using a semver compatible value, starting with `v`:
+
+```sh
+git checkout main
+git tag v0.0.0
+git push upstream v0.0.0
+```
+
+Move the corresponding release branch (starting with `r`) forward by creating a merge commit, and using the merged tag
+as the commit message:
+
+```sh
+git checkout r0
+git merge --no-ff -m 'v0.0.0' v0.0.0
+git push upstream r0
+```