Merge branch 'maintenance/skip-change-note-draft'

PR #8069

Author: webknjaz

CHANGES/8067.doc.rst

@@ -0,0 +1,3 @@
+The Sphinx setup was updated to avoid showing the empty
+changelog draft section in the tagged release documentation
+builds on Read The Docs -- by :user:`webknjaz`.

docs/changes.rst

@@ -4,14 +4,17 @@
 Changelog
 =========
 
-To be included in v\ |release| (if present)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. only:: not is_release
 
-.. towncrier-draft-entries:: |release| [UNRELEASED DRAFT]
+   To be included in v\ |release| (if present)
+   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Released versions
-^^^^^^^^^^^^^^^^^
+   .. towncrier-draft-entries:: |release| [UNRELEASED DRAFT]
+
+   Released versions
+   ^^^^^^^^^^^^^^^^^
 
 .. include:: ../CHANGES.rst
+   :start-after: .. towncrier release notes start
 
 .. include:: ../HISTORY.rst

docs/conf.py

@@ -17,6 +17,12 @@
 from pathlib import Path
 
 PROJECT_ROOT_DIR = Path(__file__).parents[1].resolve()
+IS_RELEASE_ON_RTD = (
+    os.getenv("READTHEDOCS", "False") == "True"
+    and os.environ["READTHEDOCS_VERSION_TYPE"] == "tag"
+)
+if IS_RELEASE_ON_RTD:
+    tags.add("is_release")
 
 _docs_path = os.path.dirname(__file__)
 _version_path = os.path.abspath(