[librsvg: 1/6] Update the versioning scheme - no longer even/odd




commit b9f9faf457c4aeb2093771ffc506e25006aa22b6
Author: Federico Mena Quintero <federico gnome org>
Date:   Thu Sep 8 11:55:31 2022 -0500

    Update the versioning scheme - no longer even/odd
    
    Like
    https://discourse.gnome.org/t/even-odd-versioning-is-confusing-lets-stop-doing-it/10391
    suggests.
    
    Part-of: <https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/746>

 README.md                | 20 ++++++++++----------
 devel-docs/releasing.rst | 31 +++++++++++++++++--------------
 2 files changed, 27 insertions(+), 24 deletions(-)
---
diff --git a/README.md b/README.md
index 7aa8aea27..2e9a76e7c 100644
--- a/README.md
+++ b/README.md
@@ -21,22 +21,22 @@ Table of contents:
 
 # Supported branches
 
-Generally two branches are supported:
+Generally two branches are supported at any one time:
 
-* The latest stable branch, which has an **even minor version
-  number**.  See the [branches
-  page](https://gitlab.gnome.org/GNOME/librsvg/-/branches) and look
-  for the one called `librsvg-x.yy` where the `x.yy` numbers are
-  highest, `yy` should be an even number.  You can use this branch
-  safely for production work.
+* The latest stable branch.  See the [branches
+  page](https://gitlab.gnome.org/GNOME/librsvg/-/branches) and look for
+  the one called `librsvg-x.yy` where the `x.yy` numbers are highest You
+  can use this branch safely for production work.
 
-* The `main` branch.  All development happens here; development
-  releases have an **odd minor version number**, for example `2.53.4`.
+* The `main` branch.  All development happens here.
 
 Stable branches become unsupported when a new one appears.  For
-example, `librsvg-2.52` will become unsupported when `librsvg-2.54`
+example, `librsvg-2.55` will become unsupported when `librsvg-2.56`
 appears.
 
+* [Release archive](https://gitlab.gnome.org/GNOME/librsvg/-/releases) in gitlab.gnome.org
+* [Source tarballs for download](https://download.gnome.org/sources/librsvg/) at download.gnome.org
+
 # Using librsvg
 
 * [C API documentation][c-docs]
diff --git a/devel-docs/releasing.rst b/devel-docs/releasing.rst
index b0d9579d5..2f0df11e3 100644
--- a/devel-docs/releasing.rst
+++ b/devel-docs/releasing.rst
@@ -28,7 +28,7 @@ off items while making a release.
    ``ftpadmin install librsvg-x.y.z.tar.xz``
 -  ☐ Create a `release in Gitlab <https://gitlab.gnome.org/GNOME/librsvg/-/releases>`_.
 
-For ``x.y.0`` releases, at least, do the following:
+For ``x.y.0`` releases, do the following:
 
 -  ☐ `Notify the release
    team <https://gitlab.gnome.org/GNOME/releng/-/issues>`__ on whether
@@ -48,8 +48,7 @@ Gitlab release
 
 -  ☐ If there is an associated milestone, select it too.
 
--  ☐ Fill in the release title - ``x.y.z - stable`` or
-   ``x.y.z - development``.
+-  ☐ Fill in the release title - ``x.y.z``.
 
 -  ☐ Copy the release notes from NEWS.
 
@@ -62,8 +61,8 @@ Gitlab release
    and call it
    ``librsvg-x.y.z.sha256sum - release tarball       sha256sum``.
 
-Version numbers
----------------
+Version numbers and release schedule
+------------------------------------
 
 ``configure.ac`` and ``Cargo.toml`` must have the same **package
 version** number - this is the number that users of the library see.
@@ -71,15 +70,19 @@ version** number - this is the number that users of the library see.
 ``configure.ac`` is where the **library version** is defined; this is
 what gets encoded in the SONAME of ``librsvg.so``.
 
-Librsvg follows an even/odd numbering scheme for the **package
-version**. For example, the 2.50.x series is for stable releases, and
-2.51.x is for unstable/development ones. The
-`release-team <https://gitlab.gnome.org/GNOME/releng/-/issues>`__ needs
-to be notified when a new series comes about, so they can adjust their
-tooling for the stable or development GNOME releases. File an issue in
-their `repository <https://gitlab.gnome.org/GNOME/releng/-/issues>`__ to
-indicate whether the new ``librsvg-x.y.0`` is a stable or development
-series.
+Librsvg follows `GNOME's release versioning as of 2022/September
+<https://discourse.gnome.org/t/even-odd-versioning-is-confusing-lets-stop-doing-it/10391>`_.
+(Note that it used an even/odd numbering scheme before librsvg 2.55.x)
+
+Librsvg follows `GNOME's six-month release schedule
+<https://wiki.gnome.org/ReleasePlanning>`_.
+
+The `release-team <https://gitlab.gnome.org/GNOME/releng/-/issues>`__
+needs to be notified when a new series comes about, so they can adjust
+their tooling for the stable GNOME releases. File an
+issue in their `repository
+<https://gitlab.gnome.org/GNOME/releng/-/issues>`__ to indicate that
+the new ``librsvg-x.y.0`` is a stable series.
 
 Minimum supported Rust version (MSRV)
 -------------------------------------


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]