From 9129d169f19f775b44d8d6c8087c091f953b752b Mon Sep 17 00:00:00 2001
From: Karolina Surma <ksurma@redhat.com>
Date: Jan 05 2023 13:24:55 +0000
Subject: Document _python_dist_allow_version_zero macro


Rationale: https://fedoraproject.org/wiki/Changes/Prevent-Providing-python3dist(pkg)=0

---

diff --git a/guidelines/modules/ROOT/pages/Python.adoc b/guidelines/modules/ROOT/pages/Python.adoc
index 70bea4c..f4e117e 100644
--- a/guidelines/modules/ROOT/pages/Python.adoc
+++ b/guidelines/modules/ROOT/pages/Python.adoc
@@ -1167,6 +1167,7 @@ When using sources from PyPI,
 you can use the <<pypi_source,the `+%pypi_source+` macro>>
 to generate the proper URL.
 
+[[_version_warning]]
 WARNING: Some Python packages use metadata from `git`
 (or a similar version control system)
 to construct their version string,
@@ -1830,6 +1831,13 @@ See <<Machine-readable-provides>> for more details.
 +
 If defined, <<Automatic Requires for extras>> will not be generated.
 
+[#_python_dist_allow_version_zero]
+* `+%global _python_dist_allow_version_zero 1+`
++
+From Fedora Linux 38 on, it is no longer possible to build a Python package with version 0
+to prevent <<_version_warning,an accidental loss of the actual version information>>.
+If defined, the macro will allow to build such package.
+
 === Deprecated Macros
 
 The following macros are deprecated.