From c7126f7d8b14945418864bf516a3e75ecf4a6fd1 Mon Sep 17 00:00:00 2001
From: Anatolii Hrynchuk <agrynco@gmail.com>
Date: Wed, 6 May 2026 01:22:56 +0300
Subject: [PATCH] docs: add Versioning wiki page

---
 Versioning.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 Versioning.md

diff --git a/Versioning.md b/Versioning.md
new file mode 100644
index 0000000..4f4dafe
--- /dev/null
+++ b/Versioning.md
@@ -0,0 +1,28 @@
+# Versioning
+
+Versions are managed entirely on the TeamCity side — **do not set `<Version>` in `.csproj` files**.
+
+## How it works
+
+At publish time, the TC `HrynCo / HrynCo.EF / publish` build:
+
+1. Writes the current build number into `Directory.Build.props` as `<Version>%build.number%</Version>`.
+2. Restores, builds, and packs both projects in Release configuration.
+3. Pushes the resulting `.nupkg` files to nuget.org.
+
+## Build number pattern
+
+The build number follows the pattern `1.0.<counter>` (e.g. `1.0.6`, `1.0.7`, …).
+The counter increments automatically on each successful publish run.
+
+## Releasing
+
+To release a new version: merge to `main` — the publish build triggers automatically on push to `main`.
+
+## Bumping major or minor version
+
+Update the build number pattern in TC:
+
+> **HrynCo → HrynCo.EF → publish → Edit Configuration → General → Build number format**
+
+Change `1.0.%build.counter%` to e.g. `2.0.%build.counter%`.
\ No newline at end of file