[librsvg: 6/7] Move the roadmap to the devel docs

[Marge Bot <marge-bot src gnome org>]

commit b6c50f46722be1203e741b8bb4e7da12d73c6dde
Author: Federico Mena Quintero <federico gnome org>
Date:   Thu Aug 18 12:53:15 2022 -0500

    Move the roadmap to the devel docs
    
    Part-of: <https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/730>

 CONTRIBUTING.md        |  2 +-
 devel-docs/README.md   | 29 -----------------------------
 devel-docs/index.rst   |  7 ++++---
 devel-docs/roadmap.rst | 31 +++++++++++++++++++++++++++++++
 4 files changed, 36 insertions(+), 33 deletions(-)
---
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 551bf5e98..307d02fd3 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -91,7 +91,7 @@ a new CSS property.
 What can you hack on?
 
 * [Bugs for newcomers](https://gitlab.gnome.org/GNOME/librsvg/-/issues?label_name%5B%5D=4.+Newcomers)
-* Pick something from the [development roadmap](devel-docs/README.md)!
+* Pick something from the [development roadmap](devel-docs/README.md)! FIXME: relink
 
 ### Working on the source
 
diff --git a/devel-docs/README.md b/devel-docs/README.md
index 1c1122eff..5443fc2f0 100644
--- a/devel-docs/README.md
+++ b/devel-docs/README.md
@@ -1,8 +1,5 @@
 # Development documentation for librsvg
 
-Two things here: design documents for developers of librsvg itself,
-and a roadmap for development.
-
 Before embarking on big changes, please write a little design document
 modeled on the following ones, and submit a merge request.  We can
 then discuss it before coding.  This way we will have a sort of
@@ -12,29 +9,3 @@ Design documents:
 
 * [`adding-a-property.md`](adding-a-property.md) - Tutorial on how to
   add support for a new CSS property.  Should remain always current.
-  
-* [`text-layout.md`](text-layout.md) - Status of the text layout
-  engine as of librsvg 2.52.3, and a roadmap for improvement.  Still
-  current as of 2021/Dec/17.
-
-# Roadmap - an ever-changing list of development priorities - check this often
-
-## Short term
-
-* Merge [the Rust port of the 
gdk-pixbuf-loader](https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/722).
-
-* Update the CI pipelines for the main and stable branches; a design document is upcoming.
-
-* #778 is not the common case, but worrysome.
-
-* Continue with the [revamp of the text engine](text-layout.md).
-
-## Medium term
-
-* Switch to meson, for real now.
-
-* After that, #552 - Build the C library with cargo-c.
-
-* [#459](https://gitlab.gnome.org/GNOME/librsvg/-/issues/459) - Support CSS var() for custom colors and 
other SVG properties
-
-* [#843](https://gitlab.gnome.org/GNOME/librsvg/-/issues/843) - Support CSS calc()
diff --git a/devel-docs/index.rst b/devel-docs/index.rst
index 3313b7dde..ddb1f68b4 100644
--- a/devel-docs/index.rst
+++ b/devel-docs/index.rst
@@ -3,6 +3,7 @@ Development guide for librsvg
 
 .. toctree::
    product
+   roadmap
    devel_environment
    contributing
    ci
@@ -25,9 +26,9 @@ use the then-new Scalable Vector Graphics format (SVG) for GNOME's
 icons and other graphical assets on the desktop.  Since then, it has
 evolved into a few different tools.
 
-You may want to familiarize yourself with :doc:`product` to read about
-these tools, and the things that a full build produces: the library
-itself, the ``rsvg-convert`` executable, etc.
+- :doc:`product` - What comes out of this repository once it is compiled?
+- :doc:`roadmap` - Ever-changing list of priorities for the
+  maintainers; check this often!
 
 Getting started
 ---------------
diff --git a/devel-docs/roadmap.rst b/devel-docs/roadmap.rst
new file mode 100644
index 000000000..6e3f80075
--- /dev/null
+++ b/devel-docs/roadmap.rst
@@ -0,0 +1,31 @@
+Roadmap
+=======
+
+This is an ever-changing list of development priorities for the
+maintainers of librsvg.  Check this often!
+
+Short term
+----------
+
+- Merge `the Rust port of the gdk-pixbuf-loader 
<https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/722>`_.
+
+- `Switch from autotools to the Meson build system
+  <https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/657>`_.  This may make it
+  easier to integrate the Rust-based gdk-pixbuf-loader from the last point.
+
+- Fix `issue #778 <https://gitlab.gnome.org/GNOME/librsvg/-/issues/778>`_ about incorrect
+  offsetting for layers with opacity.  Solving this should make it easier to fix the root
+  cause of `issue #1 <https://gitlab.gnome.org/GNOME/librsvg/-/issues/1>`_, where librsvg
+  cannot compute arbitrary regions for filter effects and it only takes the user-specified
+  viewport into account.
+
+- Continue with the revamp of :doc:`text_layout`.
+
+Medium term
+-----------
+
+- `Issue #459 <https://gitlab.gnome.org/GNOME/librsvg/-/issues/459>`_ - Support CSS ``var()`` for custom 
colors and other SVG properties.
+
+- `Issue #843 <https://gitlab.gnome.org/GNOME/librsvg/-/issues/843>`_ - Support CSS ``calc()``.
+
+- `Issue #635 <https://gitlab.gnome.org/GNOME/librsvg/-/issues/635>`_ - Publish to crates.io.