more-help: Add Matrix page, move help-irc and help-mailinglist to new legacy page, add #i18n Matrix to translate

5 files changed, 87 insertions, 12 deletions

diff --git a/gnome-help/C/help-irc.page b/gnome-help/C/help-irc.page
index 4b2f8361..0d16e2ae 100644
--- a/gnome-help/C/help-irc.page
+++ b/gnome-help/C/help-irc.page
@@ -3,7 +3,7 @@
       id="help-irc">
 
   <info>
-    <link type="guide" xref="more-help"/>
+    <link type="guide" xref="help-legacy"/>
     <desc>Get live support on IRC.</desc>
 
     <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
diff --git a/gnome-help/C/help-legacy.page b/gnome-help/C/help-legacy.page
new file mode 100644
index 00000000..0ab0184e
--- /dev/null
+++ b/gnome-help/C/help-legacy.page
@@ -0,0 +1,33 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide" style="tip 2column"
+      id="help-legacy">
+  <info>
+    <link type="guide" xref="more-help" group="help-legacy"/>
+
+
+    <credit type="author">
+      <name>Tiffany Antopolski</name>
+      <email>tiffany.antopolski@gmail.com</email>
+    </credit>
+
+    <credit type="author">
+      <name>Jim Campbell</name>
+      <email>jwcampbell@gmail.com</email>
+    </credit>
+    
+    <credit type="author">
+      <name>Zaria</name>
+      <email>zaria@vivaldi.net</email>
+    </credit>
+
+    <desc>Information on IRC and mailing lists.</desc>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Legacy platforms</title>
+  <p>
+    These communications platforms are no longer the recommended way to get support, but they are still maintained for those who prefer them.
+  </p>
+
+</page>
diff --git a/gnome-help/C/help-mailing-list.page b/gnome-help/C/help-mailing-list.page
index 12750060..de072f59 100644
--- a/gnome-help/C/help-mailing-list.page
+++ b/gnome-help/C/help-mailing-list.page
@@ -4,7 +4,7 @@
       id="help-mailing-list">
 
   <info>
-    <link type="guide" xref="more-help"/>
+    <link type="guide" xref="help-legacy"/>
 
     <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
     <revision pkgversion="3.10" date="2013-11-07" status="review"/>
diff --git a/gnome-help/C/help-matrix.page b/gnome-help/C/help-matrix.page
new file mode 100644
index 00000000..494d7c59
--- /dev/null
+++ b/gnome-help/C/help-matrix.page
@@ -0,0 +1,44 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" style="task" version="1.1"
+      id="help-matrix">
+  <info>
+
+    <revision version="gnome:40" date="2022-05-27" status="draft"/>
+
+    <credit type="author">
+      <name>Zaria</name>
+      <email>zaria@vivaldi.net</email>
+    </credit>
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <link type="guide" xref="more-help"/>
+    
+    <link type="seealso" href="https://matrix.org">
+        <title>Matrix homepage</title>
+    </link>
+
+
+    <desc>Chat live with GNOME contributors.</desc>
+
+    <keywords>matrix, chat, support, live, community, help</keywords>
+  </info>
+
+  <title>Get help with Matrix</title>
+
+  <p>
+  <link href="https://matrix.org/">Matrix</link> is a modern, open source chat platform. Like email, you can create an account on one of many servers and use any number of clients to connect, including web-based ones.
+  </p>
+  <steps>
+    <item><p>Choose a client. Matrix maintains a <link href="https://matrix.org/docs/projects/try-matrix-now/">list of popular clients</link>, including the popular <link href="https://app.element.io">Element</link> client and GNOME's own <link href="https://wiki.gnome.org/action/show/Apps/Fractal">Fractal</link> app.</p></item>
+    <item><p>Create an account. Most clients will guide you through this process, and the account will work on any Matrix client.</p></item>
+    <item><p>Join the <link href="https://matrix.to/#/#gnome:gnome.org">#gnome:gnome.org</link> room and ask away.</p></item>
+  </steps>
+  <p>
+  More information, including how to browse other GNOME rooms, can be found on the <link href="https://wiki.gnome.org/GettingInTouch/Matrix">GNOME wiki</link>.
+  </p>
+  <note>
+  <p>Be sure to follow the <link href="https://wiki.gnome.org/Foundation/CodeOfConduct">GNOME code of
+    conduct</link> when chatting on Matrix and other GNOME platforms.</p>
+    </note>
+
+</page>
diff --git a/gnome-help/C/translate.page b/gnome-help/C/translate.page
index fb136762..5e08445c 100644
--- a/gnome-help/C/translate.page
+++ b/gnome-help/C/translate.page
@@ -20,6 +20,10 @@
       <name>Petr Kovar</name>
       <email>pknbe@volny.cz</email>
     </credit>
+    <credit type="editor">
+        <name>Zaria</name>
+        <email>zaria@vivaldi.net</email>
+    </credit>
 
   <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
@@ -27,24 +31,18 @@
 <title>Participate to improve translations</title>
 
 <p>
-  GNOME’s help is being translated by a world-wide volunteer community. You are
-  welcome to participate.
-</p>
-<p>
-  There are <link href="https://l10n.gnome.org/module/gnome-user-docs/">many
+  GNOME’s help is being translated by a world-wide volunteer community, and
+  there are <link href="https://l10n.gnome.org/module/gnome-user-docs/">many
   languages</link> for which translations are still needed.
 </p>
 <p>
-  To start translating, you will need to
+  To start translating,
   <link href="https://l10n.gnome.org/register/">create an account</link> and
   join the <link href="https://l10n.gnome.org/teams/">translation team</link> for
   your language. This will give you the ability to upload new translations.
 </p>
 <p>
-  You can chat with GNOME translators by joining the #i18n channel on the
-  <link xref="help-irc">GNOME IRC server</link>. People on the channel are
-  located worldwide, so you may not get an immediate response as a result of
-  timezone differences.
+    Connect with other GNOME translators in the <link href="https://matrix.to/#/#i18n:gnome.org">#i18n:gnome.org</link> Matrix room. See the <link xref="help-matrix">Get help with Matrix</link> page for more information. If you prefer, there is also an IRC channel, #i18n, on the <link xref="help-irc">GNOME IRC server</link>. As the people in these rooms are located across the world, it may take a moment to get a response.
 </p>
 <p>
   Alternatively, you can contact the Internationalization Team using their