Merge branch 'readme-updates' into 'main'

README.md: Update links

See merge request GNOME/librsvg!785

2 files changed, 27 insertions, 13 deletions

diff --git a/README.md b/README.md
index abd9ce7b..2ccb5845 100644
--- a/README.md
+++ b/README.md
@@ -61,7 +61,8 @@ tracker][bugs].  Please see the "[reporting bugs][reporting-bugs]"
 page in the development guide to see how to provide a good bug report.
 
 **Asking questions:** Feel free to ask questions about using librsvg
-in the [desktop-devel-list][d-d-l] mailing list.
+in the "Platform" category of [GNOME's Discourse][discourse].  You can
+also ask via chat in the Matrix room for [GNOME Rust][gnome-rust].
 
 **Programming languages:** Librsvg exports its API through [GObject
 Introspection][gi].  This way, it is available in many programming
@@ -79,10 +80,10 @@ chapter][security] in the development guide.
 # Contributing to librsvg's development
 
 There is a code of conduct for contributors to librsvg; please see the
-[GNOME Code of Conduct][conduct], which is duplicated in the file
-[`code-of-conduct.md`][coc].
+[GNOME Code of Conduct][coc], which is duplicated in the file
+[`code-of-conduct.md`][coc-local].
 
-Please see the [Development guide for librsvg][devel-guide] on how to
+Please see the [Development Guide for librsvg][devel-guide] on how to
 contribute to librsvg, how to report bugs, how set up your development
 environment, and for a description of librsvg's architecture.
 
@@ -100,8 +101,8 @@ API" kind of library.
 
 Feature additions will be considered on a case-by-case basis.
 
-You can read about librsvg's supported SVG and CSS features in the
-[FEATURES.md](FEATURES.md) file.
+You can read about librsvg's [supported SVG and CSS features][features] in the
+development guide.
 
 # Non-goals of librsvg
 
@@ -189,6 +190,10 @@ ways:
   convenient time for you, feel free to [mail me][mail] and we can
   arrange a time.
 
+* I frequently [blog about librsvg][blog].  You may be interested in
+  the articles about porting librsvg from C to Rust, which happened
+  between 2016 and 2020.
+
 [svg]: https://en.wikipedia.org/wiki/Scalable_Vector_Graphics
 [gnome]: https://www.gnome.org/
 [cairo]: https://www.cairographics.org/
@@ -198,9 +203,10 @@ ways:
 [compiling]: https://gnome.pages.gitlab.gnome.org/librsvg/devel-docs/compiling.html
 [mail]: mailto:federico@gnome.org
 [bugs]: https://gitlab.gnome.org/GNOME/librsvg/issues
-[gi]: https://wiki.gnome.org/Projects/GObjectIntrospection
+[gi]: https://gi.readthedocs.io/en/latest/
 [contributing]: https://gnome.pages.gitlab.gnome.org/librsvg/devel-docs/contributing.html
 [reporting-bugs]: https://gnome.pages.gitlab.gnome.org/librsvg/devel-docs/bugs.html
+[discourse]: https://discourse.gnome.org/c/platform/5
 [d-d-l]: https://mail.gnome.org/mailman/listinfo/desktop-devel-list
 [federico]: https://viruta.org/
 [platform]: https://developer.gnome.org/
@@ -210,3 +216,5 @@ ways:
 [gnome-rust]: https://matrix.to/#/#rust:gnome.org
 [devel-guide]: https://gnome.pages.gitlab.gnome.org/librsvg/devel-docs/index.html
 [security]: https://gnome.pages.gitlab.gnome.org/librsvg/devel-docs/security.html
+[features]: https://gnome.pages.gitlab.gnome.org/librsvg/devel-docs/features.html
+[blog]: https://viruta.org/tag/librsvg.html
diff --git a/devel-docs/security.rst b/devel-docs/security.rst
index 66862be0..5b0f756f 100644
--- a/devel-docs/security.rst
+++ b/devel-docs/security.rst
@@ -11,13 +11,19 @@ mail.
 Librsvg releases with security fixes
 ------------------------------------
 
-Librsvg releases have a version number like major.minor.micro. Note that
-releases with an odd minor number (e.g. 2.47.x since 47 is odd) are
-considered development releases and should not be used in production
-systems.
+Librsvg releases have a version number like major.minor.micro.
 
-The following list is only for stable release streams, where the minor
-number is even (e.g. 2.50.x).
+Before version 2.55.x, librsvg's versioning scheme was such that a
+release with an *even* minor number was considered a stable release
+suitable for production use (e.g. 2.54.x), and an *odd* minor number
+was a development release only.
+
+Starting with 2.55.x, all minor numbers are considered stable.
+Development and beta versions have a micro version starting at 90
+(e.g. 2.55.90), per `GNOME's release versioning as of 2022/September
+<https://discourse.gnome.org/t/even-odd-versioning-is-confusing-lets-stop-doing-it/10391>`_.
+
+The following list is only for stable release streams.
 
 2.50.4
 ~~~~~~