GNOME.org
 

[gimp-web] content, themes: merging irc and mailing lists pages into a single…

commit aed24781cdf13b8762d9ec67fe5219554f9a1a0e
Author: Jehan <jehan girinstud io>
Date:   Wed Nov 10 15:02:13 2021 +0100

    content, themes: merging irc and mailing lists pages into a single…
    
    … "Discuss" page.
    
    Create new page "discuss.html", aggregating contents of the former (now
    deleted with this commit) irc.html and mail_lists.html:
    
    * IRC, Mailing lists and Discord are put on the same level (3
      different sections in a same page).
    * Common discussion channels introduction with info of only listing
      official spaces (yet encouraging third-party discussion spaces), a
      single code of conduct, a security warning about these being public
      and often archived and a table of conduct for easy jumping.
    * Much redundant text is removed, as applying to all communication
      media anyway.
    * Using markdown rather than html-in-markdown in various places.
    * Shortened descriptions of IRC channels and mailing lists while
      keeping the core ideas (straighter to the point).
    * Removing "nabble" from mailing list archives (seems to not exist
      anymore).
    * Some rewording of code of conduct, merging of similar rules in the
      IRC and mailing list pages…
    * Some rules were removed (please everyone, double-check): e.g. the
      "jester license" rule (nobody is against humor — we love to laugh
      too! —, as long as you stay respectful; there are no special rights);
      or the "special privileges" for GIMP developers who'd have rights to
      abuse them (same: we expect everyone to be nice to others, developers
      or not).
    * The "Don't make fun of other people's language" is part of being
      respectful. I just had a mention of it in the "Write in English" rule
      to tell people they should not be afraid of being mocked for their
      English (they won't be!).
    * Also removed mentions like expecting "RTFM" or "use Google". People
      are still expected to search beforehand and not to needlessly bother
      others, but if this happens, we'd tell it nicely, in a formative way.
    * Updated the "Don't expect to be greeted" with a bit of background.
      It's still nice to say hello (I often say hello/goodbye in IRC too),
      but just not give any meaning to having no answers (sometimes you do,
      sometimes not). Oppositely speaking directly is not considered rude on
      these channels. Both are possible, let's just not imagine negative
      meanings.
    * Add sublists for rules specific to mailing lists and to real-time
      channels.
    * Removed the mention "The code may change in the future, followed by
      a notification to subscribers" as I have no idea what it even means
      in the end of the code of conduct.
    * Better source list with an internal anchor ID to link it from the
      appropriate "Do basic research" rule.
    * Updating website footer.

 content/about/discuss.md           | 153 +++++++++++++++++++++++++++++++++++++
 content/about/irc.md               |  52 -------------
 content/about/mail_lists.md        |  97 -----------------------
 themes/newgimp/templates/base.html |   3 +-
 4 files changed, 154 insertions(+), 151 deletions(-)
---
diff --git a/content/about/discuss.md b/content/about/discuss.md
new file mode 100644
index 00000000..e38b181e
--- /dev/null
+++ b/content/about/discuss.md
@@ -0,0 +1,153 @@
+Title: Discuss
+Date: 2021-11-10
+Author: Jehan
+url: discuss.html
+save_as: discuss.html
+status: hidden
+
+To discuss features, tips, tricks or contribute to development, the
+below discussion channels are available.
+
+Note that we only list spaces moderated by the GIMP team.
+Our project encourages community process so many community-led spaces
+exist to discuss about GIMP as well (forums, chat systems…) without our
+supervision.
+
+In any of the official channels, you are expected to follow our [code of
+conduct](#code-of-conduct).
+
+[TOC]
+
+⚠️ Warning: mailing lists are _publicly available_ and _archived_ for
+__anyone__ to read. In some cases they are even archived in places
+outside of our control. Other discussions channels are not necessarily
+centrally archived, yet many users store every discussion happening.
+Don't send any private or sensitive information! ⚠️
+
+## IRC
+
+The official GIMP IRC channels are on GIMPNet
+([irc.gimp.org](irc://irc.gimp.org/)) and have existed for more than 20
+years. Many [channels related to GTK+ and
+GNOME](https://live.gnome.org/GnomeIrcChannels) are also on GIMPNet.
+
+irc://irc.gimp.org/[#gimp-users](irc://irc.gimp.org/gimp-users)
+: Main support channel for GIMP users.
+
+irc://irc.gimp.org/[#gimp](irc://irc.gimp.org/gimp)
+: Original channel, created in early 1997 for users and developers.
+Discussions often focus on GIMP development.
+
+irc://irc.gimp.org/[#gimp-web](irc://irc.gimp.org/gimp-web)
+: Channel devoted to this web site and related GIMP sites.
+
+## Mailing Lists
+
+[GIMP User](https://mail.gnome.org/mailman/listinfo/gimp-user-list)
+: Main list for questions about using GIMP.<br/>
+*Archives: [GNOME](https://mail.gnome.org/archives/gimp-user-list/),
+[mail-archive](https://www.mail-archive.com/gimp-user-list%40gnome.org/),
+[spinics](https://www.spinics.net/lists/gimp/) / Old Archives:
+[mail-archive](https://www.mail-archive.com/gimp-user%40lists.xcf.berkeley.edu/)*
+
+[GIMP Developer](https://mail.gnome.org/mailman/listinfo/gimp-developer-list)
+: GIMP developer list. For plug-in developers and core program
+developers; discussion about the source code.<br/>
+*Archives: [GNOME](https://mail.gnome.org/archives/gimp-developer-list/),
+[mail-archive](https://www.mail-archive.com/gimp-developer-list%40gnome.org/) /
+Old Archives:
+[mail-archive](https://www.mail-archive.com/gimp-developer%40lists.xcf.berkeley.edu/)*
+
+[GEGL Developer](https://mail.gnome.org/mailman/listinfo/gegl-developer-list)
+: GEGL developer list. For developers interested in contributing to <a
+href="http://www.gegl.org/";>GEGL</a>, the new architecture for image
+processing.<br/>
+*Archives: [GNOME](https://mail.gnome.org/archives/gegl-developer-list/),
+[mail-archive](https://www.mail-archive.com/gegl-developer-list%40gnome.org/) /
+Old Archives: [mail-archive](https://www.mail-archive.com/gegl-developer%40lists.xcf.berkeley.edu/)*
+
+[GIMP GUI](https://mail.gnome.org/mailman/listinfo/gimp-gui-list)
+: GIMP GUI list. For discussions around UI/UX.<br/>
+*Archives: [GNOME](https://mail.gnome.org/archives/gimp-gui-list/),
+[mail-archive](https://www.mail-archive.com/gimp-gui-list%40gnome.org/)*
+
+[GIMP Web](https://mail.gnome.org/mailman/listinfo/gimp-web-list)
+: GIMP web list. For discussions about contents and structure of this
+web site.<br/>
+*Archives: [GNOME](https://mail.gnome.org/archives/gimp-web-list/),
+[mail-archive](https://www.mail-archive.com/gimp-web-list%40gnome.org/)*
+
+[GIMP Docs](https://mail.gnome.org/mailman/listinfo/gimp-docs-list)
+: GIMP documentation list. For discussions about the <a
+href="https://docs.gimp.org";>GIMP User Manual</a> and all derivative
+works.<br/>
+*Archives: [GNOME](https://mail.gnome.org/archives/gimp-docs-list/),
+[mail-archive](https://www.mail-archive.com/gimp-docs-list%40gnome.org/) /
+Old Archives:
+[mail-archive](https://www.mail-archive.com/gimp-docs%40lists.xcf.berkeley.edu/)*
+
+## Discord
+
+A [Discord server](https://discord.gg/W28dWtku2W) is also available.
+
+## Code of Conduct
+
+Communication channels between contributors and users of GIMP are
+important. Therefore we urge you to follow the following common
+etiquette rules. Failure to observe these or instructions from the
+moderators may be grounds for reprimand, probation, or removal.
+
+* **Be considerate and respectful**. Every email in our most popular
+  mailing lists may be read by thousands of subscribers and then
+  aggregated to be seen by an even larger audience. Other channels
+  usually have dozens or hundreds of subscribers. Please make sure that
+  you add value to the discussion, avoid repetitive arguments,
+  flamewars, trolling, and personal attacks.
+* **Write in English**. While the GIMP community is multinational, we
+  need a _lingua franca_ for communication which happens to be
+  English. It's OK to have bad English skills as long as you do your
+  best. Nobody will mock your English (this would go against the first
+  rule of being respectful).
+* **Do basic research**. Chances are that your questions, feature
+  requests, or bug reports have already been thoroughly documented and
+  discussed. See the list of [sources](#research-sources) for reference
+  below.
+* **Be specific**. When describing a problem, please always mention:
+  operating system and its version, architecture (32bit, 64bit…), exact
+  version of GIMP (use `Help->About` for reference).
+* For mailing-lists specifically:
+    - **Stick to plain text**. Please don't send emails in HTML.
+    - **Keep it short**. When replying long threads, please trim
+      unnecessary content and write your replies inline instead of "top
+      posting".
+* For real-time channels (IRC, Discord) specifically:
+    - **Be patient**. IRC offers real-time communication, but be aware
+      that there may be long periods of silence in the channels when other
+      people are busy or away from their keyboards. Receiving answers
+      after a few hours is not unheard of. Therefore asking, then doing
+      something else while leaving the window opened and checking from
+      time to time if there are answers is not considered rude
+      because everyone is aware that others have lives too.
+    - **Don't ask to ask, just ask**. Questions like "*May I ask a
+      question?*" are redundant. Questions like "*Can someone help me?*"
+      cannot be answered until you have described your problem. Be
+      polite yet direct and describe your problem or question
+      immediately.
+    - **Don't expect to be greeted**. You are free to say hello but
+      receiving no answers does not mean anything bad. Talking directly or
+      just listening is perfectly acceptable behavior too.
+
+
+<span id="research-sources">*List of sources to check for information on
+the project, roadmap, feature requests, bug reports etc. before asking
+questions*</span>:
+
+* *Your favorite web search engine*.
+* [Documentation](https://www.gimp.org/docs/).
+* [Bug tracker](https://gitlab.gnome.org/GNOME/gimp/issues). Useful for checking bug reports and feature 
requests.
+* [FAQ](https://www.gimp.org/docs/userfaq.html). Some frequently asked questions we already replied.
+* [Roadmap](https://wiki.gimp.org/index.php/Roadmap). Where some of the plans are outlined.
+* [Usability](https://gui.gimp.org). Ongoing work to improve user experience of GIMP.
+* [Development](https://wiki.gimp.org/index.php/Main_Page). If you wish to contribute, please check the wiki 
for basic information for developers.
+
+We also suggest checking archives of the mailing lists for existing discussions.
diff --git a/themes/newgimp/templates/base.html b/themes/newgimp/templates/base.html
index 904a33bc..b78a0e3d 100644
--- a/themes/newgimp/templates/base.html
+++ b/themes/newgimp/templates/base.html
@@ -210,7 +210,7 @@
                     <div class='column third'>
                         <ul>
                             <li><a href='/bugs/'>Bug Reports</a></li>
-                            <li><a href='/mail_lists.html'>Mailing Lists</a></li>
+                            <li><a href='/discuss.html'>Discuss</a></li>
                             <li><a href='/books/'>Books</a></li>
                             <li><a href='/donating/sponsors.html'>Sponsors</a></li>
                         </ul>
@@ -218,7 +218,6 @@
 
                     <div class='column third'>
                         <ul class='social-links'>
-                            <li><a href='/irc.html'>IRC</a></li>
                             <li><a href='https://twitter.com/gimp_official' title='Follow us on 
Twitter'>Twitter</a></li>
                             <li><a href='https://www.facebook.com/gimpofficial/' title='Follow us on 
Facebook'>Facebook</a></li>
                         </ul>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]