Clarify version policy for semver

tomschr · tomschr · commit c552a591b7fb · 2023-10-09T09:44:46.000+02:00
diff --git a/README.rst b/README.rst
@@ -12,19 +12,8 @@ A Python module to simplify `semantic versioning`_.
 
 .. note::
 
-   This project works for Python 3.7 and greater only. If you are
-   looking for a compatible version for Python 2, use the
-   maintenance branch |MAINT|_.
-
-   The last version of semver which supports Python 2.7 to 3.5 will be
-   2.x.y However, keep in mind, the major 2 release is frozen: no new
-   features nor backports will be integrated.
-
-   We recommend to upgrade your workflow to Python 3 to gain support,
-   bugfixes, and new features.
-
-.. |MAINT| replace:: ``maint/v2``
-.. _MAINT: https://github.com/python-semver/python-semver/tree/maint/v2
+   This project works for Python 3.7 and greater only.
+   Refer to :ref:`version-policy` for more details.
 
 
 The module follows the ``MAJOR.MINOR.PATCH`` style:
diff --git a/docs/index.rst b/docs/index.rst
@@ -12,6 +12,7 @@ Semver |version| -- Semantic Versioning
 
    build-semver
    install
+   version-policy
    usage/index
    migration/index
    advanced/index
diff --git a/docs/version-policy.rst b/docs/version-policy.rst
@@ -0,0 +1,45 @@
+.. _version-policy:
+
+Version Policy
+==============
+
+.. |MAINT| replace:: ``maint/v2``
+.. _MAINT: https://github.com/python-semver/python-semver/tree/maint/v2
+.. |CHANGELOG| replace:: ``Changelog``
+.. _CHANGELOG: https://github.com/python-semver/python-semver/blob/maint/v2/CHANGELOG.rst
+
+
+semver v2
+---------
+
+Active development of major version 2 has stopped. No new features nor
+backports will be integrated.
+We recommend to upgrade your workflow to Python 3 to gain support,
+bugfixes, and new features.
+
+If you still need this old version, use the  |MAINT|_ branch.
+
+Refer to the |CHANGELOG|_ if you need some details.
+
+
+semver v3
+---------
+
+We will not intentionally make breaking changes in minor releases of V3.
+
+Methods marked as ``deprecated`` and raise a warning when used.
+
+
+semver v3 and beyond
+--------------------
+
+Methods that were marked as deprecated will be very likely be removed.
+
+
+Support for Python versions
+---------------------------
+
+This project will drop support for a Python version when the
+following conditions are met:
+
+* The Python version has reached `EOL <https://devguide.python.org/versions/>`_.
