diff --git a/CHANGELOG.md b/CHANGELOG.md
index 26e25b2b..dd895f45 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -46,6 +46,7 @@
 - fix #1139: use logging.lastResort instead of a own replica to avoid polluting logging._handlerList
 - fix #873: don't infer version in cli if --no-version is given
 - fix #535: accept tags from a release action in the gh ui
+- fix #1073: explain namespaces for release-branch-semver
 
 ## v8.3.1
 
diff --git a/docs/extending.md b/docs/extending.md
index 0436b138..c4cc2e03 100644
--- a/docs/extending.md
+++ b/docs/extending.md
@@ -120,8 +120,12 @@ representing the version.
     non-release branch, increments the minor segment and sets the micro segment to
     zero, then appends `.devN`
 
+    Namespaces are unix pathname separated parts of a branch/tag name.
+
     **Examples:**
     - Tag `1.0.0` on release branch `release-1.0` → version `1.0.1.devN`
+
+    - Tag `1.0.0` on release branch `release/v1.0` → version `1.0.1.devN`
     - Tag `1.0.0` on development branch → version `1.1.0.devN`
 
 ### `setuptools_scm.local_scheme`