[gimp-help] Change: improve the text on the website a bit

[Jacob Boerema <jboerema src gnome org>]

commit e6f0ab8e0b0e5a3bb027e2d4c01dd672b854bb9a
Author: Jacob Boerema <jgboerema gmail com>
Date:   Mon Jul 18 18:23:57 2022 -0400

    Change: improve the text on the website a bit
    
    (cherry picked from commit 99eb03e2d484f9022352d6ba7a84ab1c8249fa3e)

 web/help.xml    | 36 +++++++++++++++++++++++++++++++++---
 web/website.xml | 14 ++++++++------
 2 files changed, 41 insertions(+), 9 deletions(-)
---
diff --git a/web/help.xml b/web/help.xml
index 7e4411407..2b4aced57 100644
--- a/web/help.xml
+++ b/web/help.xml
@@ -104,22 +104,52 @@
       difficult. If you are uncertain about something, you can always ask, see
       the links below on how to contact us.
     </para>
+  </section>
+  <section id="contact">
+    <title>Contacting the Documentation Team</title>
     <para>
       It would be a good idea to subscribe to some of GIMP's
       <ulink url='https://www.gimp.org/discuss.html#mailing-lists'>mailing lists</ulink>,
-      especially the developer and docs lists. That way you can keep up to date
-      about the development of GIMP.
+      especially the docs (for documentation related questions) and developer
+      (if you are unsure how a certain feature should be documented) lists.
+      That way you can keep up to date about the development of GIMP.
+    </para>
+    <para>
       Most of the GIMP developers can also be reached on the
       <ulink url='https://www.gimp.org/discuss.html#irc-matrix'>#gimp IRC channel</ulink>
       on irc.gimp.org. The best chances to talk are usually during European
       evening hours, but be patient, getting an answer can take a while. Note
       that there is no need to ask if you can ask a question: just ask.
     </para>
+    <para>
+      For specific documentation questions you can also open a new issue or
+      comment on an open issue.
+    </para>
+  </section>
+  <section id="submissions">
+    <title>Submitting your changes</title>
     <para>
       Before you can send us your changes you should have a Gnome Gitlab
       account and fork the gimp-help repository. For each new issue you work
       on, please make a separate branch. When ready push your changes to
-      your branch and then open a MR (merge request).
+      your branch and then open a merge request (MR).
+    </para>
+    <para>
+      We will then look at your changes and possibly suggest or request further
+      changes. If everything looks fine, your MR will be merged into our
+      documentation. Note: we are all volunteers here, so be patient. Getting
+      back to you can take time. Most of the time we will get back to you
+      within a week, but sometimes it will take considerably longer.
+    </para>
+    <para>
+      Make sure that the e-mail address connected to your Gnome GitLab account
+      receives notifications when someone comments on your MR. Notification
+      settings can be changed in your Gnome GitLab account.
+    </para>
+    <para>
+      More info on
+      <ulink url='https://gitlab.gnome.org/GNOME/gimp-help/-/tree/master#tips-for-contribution'>
+      contributing</ulink> can be found in our repository.
     </para>
   </section>
 
diff --git a/web/website.xml b/web/website.xml
index 19513bdeb..8e31d8a51 100644
--- a/web/website.xml
+++ b/web/website.xml
@@ -45,15 +45,17 @@
       <title>Work in Progress</title>
       <para>
         The US English manual, that is used as the base for translations, is
-        known to contain errors and omissions. Please note that both this
-        manual and the translations are works in progress and can be
-        incomplete. We apologize for any inconvenience this may cause.
+        known to contain outdated sections, errors and omissions. Please note
+        that both this manual and the translations are works in progress and
+        may be incomplete. We apologize for any inconvenience this may cause.
       </para>
       <para>
         To improve the manual and translations we are looking for more
-        volunteers to help us out. If you are interested in writing for the
-        English language manual, or in translating the manual, then please
-        get in contact with us.
+        volunteers to help us out. If you are interested in
+        <ulink url="help.html#content">writing documentation</ulink> for the
+        English language manual, or in
+        <ulink url="help.html#translate">translating</ulink> the manual, then
+        please get in <ulink url="help.html#contact">contact</ulink> with us.
       </para>
     </note>