[librsvg: 1/6] Update the versioning scheme - no longer even/odd
- From: Marge Bot <marge-bot src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [librsvg: 1/6] Update the versioning scheme - no longer even/odd
- Date: Tue, 13 Sep 2022 02:14:14 +0000 (UTC)
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]