diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 535e5ae3..52482c77 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -29,7 +29,7 @@ body:
     id: version
     attributes:
       label: Heddle version
-      placeholder: e.g. 4.0.2
+      placeholder: e.g. 1.0.0
     validations:
       required: true
   - type: input
diff --git a/docs/README.md b/docs/README.md
index dfb72054..c4483b73 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -12,7 +12,9 @@ The engine is published as two NuGet packages:
 | `Heddle` | [src/Heddle](../src/Heddle) | Core engine: parser host, compiler, runtime, built‑in extensions. |
 | `Heddle.Language` | [src/Heddle.Language](../src/Heddle.Language) | ANTLR grammar + generated lexer/parser, plus editor (Ace) assets. |
 
-Current version: **4.0.2** (see [src/Heddle/Heddle.csproj](../src/Heddle/Heddle.csproj)).
+Current version: **1.0.0**. The published version always follows the latest
+[release tag](https://github.com/multiarc/Heddle/releases) /
+[nuget.org](https://www.nuget.org/packages/Heddle).
 
 ---
 
diff --git a/docs/building.md b/docs/building.md
index 8ddd240b..3b22b734 100644
--- a/docs/building.md
+++ b/docs/building.md
@@ -35,7 +35,8 @@ dotnet test src/Heddle.Tests
 
 All shipping projects use `LangVersion=latest` and are **strong‑name signed** with
 `heddle.snk` (`SignAssembly=true`, `AssemblyOriginatorKeyFile=..\..\heddle.snk`).
-Current package version is **4.0.2** (with an optional `$(VersionSuffix)`).
+The initial public release is **1.0.0**; the published version is set from the release tag
+(`vX.Y.Z`) at publish time, so the version in the source tree is just a placeholder.
 
 ### Key dependencies