From 813e8a3a3a19db012badba342a52e9aab651c24b Mon Sep 17 00:00:00 2001
From: light7734 <light7734@tuta.io>
Date: Wed, 6 Aug 2025 12:13:07 +0330
Subject: [PATCH] docs(guidelines/development): add semantic versioning

---
 docs/guidelines/development.rst | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/docs/guidelines/development.rst b/docs/guidelines/development.rst
index ba4baa0..4d3c799 100644
--- a/docs/guidelines/development.rst
+++ b/docs/guidelines/development.rst
@@ -93,3 +93,32 @@ With the following commit types:
 
 - asset
 - test
+Semantic Versioning
+---------------------------------------------------------------------------------------------------
+Coupled with conventional commit style messages, we can automajically version the project following
+the **Semantic Versioning 2.0.0** specifications.
+
+The full version identifier consits of a version core (major.minor.patch) + label + hexsha of the commit.
+Using the following format:
+
+
+.. code-block:: md
+
+    <major>.<minor>.<patch>-<label>+<short_hexsha>
+
+    eg.
+    0.8.1-kitten+ea898 
+    0.5.0-kitten+01d85
+    1.5.0-akasha+7de53
+
+    kitten refers to all pre-release (1.0.0) versions
+
+
+The shortened hexsha of a commit is obtained by:
+``git rev-parse --short=5 <commit_hexsha>``
+
+
+
+
+
+