Document use of calendar-based versioning scheme (#717)

faph · web-flow · commit 39786bb4bf66 · 2023-09-02T14:16:29.000+01:00
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -4,6 +4,7 @@ Changelog
 *unreleased*
 ~~~~~~~~~~~~
 
+* Document calendar-based versioning scheme (:issue:`716`)
 * Enforce that the entire marker string is parsed (:issue:`687`)
 * Requirement parsing no longer automatically validates the URL (:issue:`120`)
 * Canonicalize names for requirements comparison (:issue:`644`)
diff --git a/README.rst b/README.rst
@@ -34,6 +34,8 @@ Use ``pip`` to install these utilities::
 
     pip install packaging
 
+The ``packaging`` library uses calendar-based versioning (``YY.N``).
+
 Discussion
 ----------
 
diff --git a/docs/index.rst b/docs/index.rst
@@ -15,6 +15,8 @@ You can install packaging with ``pip``:
 
     $ pip install packaging
 
+The ``packaging`` library uses calendar-based versioning (``YY.N``).
+
 
 .. toctree::
     :maxdepth: 1
