eslupmi · DiTsi · Sep 18, 2026 · Sep 18, 2026
diff --git a/docs/content/development/branching.excalidraw.svg b/docs/content/development/branching.excalidraw.svg
diff --git a/docs/content/development/branching.md b/docs/content/development/branching.md
@@ -0,0 +1,9 @@
+# Branching
+
+`develop` is the main development branch. 
+
+Feature branches are always created from `develop`. 
+
+The `master` branch is updated only through merge requests from `develop` or via dedicated `hotfix` branches for critical fixes.
+
+![None](./branching.excalidraw.svg)
diff --git a/docs/content/development/cd.excalidraw.svg b/docs/content/development/cd.excalidraw.svg
diff --git a/docs/content/development/ci-cd.md b/docs/content/development/ci-cd.md
@@ -0,0 +1,9 @@
+# CI / CD
+
+## CI
+
+![None](./ci.excalidraw.svg)
+
+## CD
+
+![None](./cd.excalidraw.svg)
diff --git a/docs/content/development/ci.excalidraw.svg b/docs/content/development/ci.excalidraw.svg
diff --git a/docs/content/development/release.md b/docs/content/development/release.md
@@ -0,0 +1,25 @@
+# Release checklist
+
+Applies by release type: **M** major; **m** minor; **b** bugfix
+
+## On PR
+
+| Task | M | m | b |
+| --- | --- | --- | --- |
+| Bump the Python bugfix version in the Dockerfile (if possible) | ✓ | ✓ | |
+| Verify images in the latest [docs.impulse.bot](https://docs.impulse.bot) | ✓ | ✓ | |
+
+## After merge to `master`
+
+| Task | M | m | b |
+| --- | --- | --- | --- |
+| Check migrations on prod | ✓ | ✓ | ✓ |
+| Create a GitHub release | ✓ | ✓ | ✓ |
+| Close the GitHub milestone | ✓ | ✓ | ✓ |
+
+## After release
+
+| Task | M | m | b |
+| --- | --- | --- | --- |
+| Create Community Helm Chart release | ✓ | ✓ | ✓ |
+| Update the Features section on the website | ✓ | ✓ | |
diff --git a/docs/content/development/rules.md b/docs/content/development/rules.md
@@ -0,0 +1,7 @@
+# Development Rules
+
+1. All **documentation** changes must be made as part of a feature, bug fix, or other related change.
+
+    Documentation should not be updated independently from the change it describes.
+
+2. Features that are not covered by automated tests and may break existing functionality must be **manually tested** before being merged into `develop`.
diff --git a/docs/listen.sh b/docs/listen.sh
@@ -1,4 +1,4 @@
 #!/bin/bash
 
-. venv/bin/activate
+. .venv/bin/activate
 mkdocs serve -a 0.0.0.0:8000
diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
@@ -55,6 +55,11 @@ nav:
     - concepts/messengers.md
     - concepts/special_variables.md
     - concepts/templates.md
+  - Development:
+    - development/branching.md
+    - development/ci-cd.md
+    - development/rules.md
+    - development/release.md
 - IMPULSE SERVER:
   - installation.md
   - Configuration: