[librsvg: 7/9] Fix references to presentations in the README; add them to the development guide




commit a3bb8fc5dc9f94724c4489bb1e31a62f3e0dcaa7
Author: Federico Mena Quintero <federico gnome org>
Date:   Thu Aug 25 18:05:03 2022 -0500

    Fix references to presentations in the README; add them to the development guide
    
    Part-of: <https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/735>

 README.md            |  6 +++---
 devel-docs/index.rst | 34 ++++++++++++++++++++++++++++++++--
 2 files changed, 35 insertions(+), 5 deletions(-)
---
diff --git a/README.md b/README.md
index 03dcb13ea..7aa8aea27 100644
--- a/README.md
+++ b/README.md
@@ -197,7 +197,7 @@ ways:
 [contributing]: CONTRIBUTING.md
 [reporting-bugs]: CONTRIBUTING.md#reporting-bugs
 [d-d-l]: https://mail.gnome.org/mailman/listinfo/desktop-devel-list
-[federico]: https://people.gnome.org/~federico/
+[federico]: https://viruta.org/
 [platform]: https://developer.gnome.org/
-[guadec-presentation-1]: https://people.gnome.org/~federico/blog/docs/fmq-porting-c-to-rust.pdf
-[guadec-presentation-2]: https://people.gnome.org/~federico/blog/docs/fmq-refactoring-c-to-rust.pdf
+[guadec-presentation-1]: https://viruta.org/docs/fmq-porting-c-to-rust.pdf
+[guadec-presentation-2]: https://viruta.org/docs/fmq-refactoring-c-to-rust.pdf
diff --git a/devel-docs/index.rst b/devel-docs/index.rst
index f20161184..3a3d2e420 100644
--- a/devel-docs/index.rst
+++ b/devel-docs/index.rst
@@ -86,8 +86,38 @@ Documentation on the CI.
 References
 ----------
 
-Link to SVG/CSS specs; other useful bits.
+- `SVG2 specification <https://www.w3.org/TR/SVG2/>`_.  This is the current Candidate Recommendation and it 
should
+  be your main reference...
 
-Links to Mozilla's SVG, WebKit, resvg, Inkscape.
+- ... except for things which are later clarified in the `SVG2 Editor's Draft 
<https://svgwg.org/svg2-draft/>`_.
+
+- `Filter Effects Module Level 1 <https://www.w3.org/TR/filter-effects/>`_.
+
+- `References listed in the SVG2 spec
+  <https://www.w3.org/TR/SVG2/refs.html>`_ - if you need to consult
+  the CSS specifications.
+  
+- `SVG1.1 specification <https://www.w3.org/TR/SVG11/>`_.  Use this mostly for historical reference.
+
+- `SVG Working Group repository
+  <https://github.com/w3c/svgwg/tree/master>`_.  The github issues are
+  especially interesting.  Use this to ask for clarifications of the
+  spec.
+
+- `SVG Working Group page <https://svgwg.org/>`_.
+
+- Presentation at GUADEC 2017, `Replacing C library code with Rust: What I learned with
+  librsvg <https://viruta.org/docs/fmq-porting-c-to-rust.pdf>`_.    It gives
+  a little history of librsvg, and how/why it was being ported to Rust
+  from C.
+
+- Presentation at GUADEC 2018, `Patterns of refactoring C to Rust: the case of
+  librsvg <https://viruta.org/docs/fmq-refactoring-c-to-rust.pdf>`_.  It
+  describes ways in which librsvg's C code was refactored to allow
+  porting it to Rust.
+
+- `Federico Mena's blog posts on librsvg
+  <https://viruta.org/tag/librsvg.html>`_ - plenty of of history and
+  stories from the development process.
 
 Talks on librsvg.


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