From 02ee2855438cc1dc5198155e4ac895fec34f987d Mon Sep 17 00:00:00 2001
From: Christoph Groth <christoph.groth@cea.fr>
Date: Fri, 31 Jul 2015 18:21:01 +0200
Subject: [PATCH] improve information about mailing lists

---
 content/community.txt | 40 ++++++++++++++++++++++------------------
 1 file changed, 22 insertions(+), 18 deletions(-)

diff --git a/content/community.txt b/content/community.txt
index 5935f17..74f436a 100644
--- a/content/community.txt
+++ b/content/community.txt
@@ -8,6 +8,14 @@ The mailing list is the main public communication platform for anything related
 to Kwant: questions, bug reports, discussions, and announcements.  You can use
 it in various ways:
 
+- .. raw:: html
+
+      <p><form id="searchgmane" method="get" action="http://search.gmane.org/">
+      <input type="text" name="query" size=25 value="Your query" onblur="if (this.value == '') {this.value='Your query'}" onfocus="if (this.value == 'Your query') {this.value=''}" />
+      <input type="hidden" name="group" value="gmane.comp.science.kwant.user" />
+      <input type="submit" value="Search the mailing list" />
+      </form></p>
+
 - .. raw:: html
 
      <form method=post action="https://mailman-mail5.webfaction.com/subscribe/kwant-discuss">
@@ -15,20 +23,12 @@ it in various ways:
      <input type="submit" name="email-button" value="Subscribe to the mailing list" />
      </form>
 
-  … and read it together with your regular email.  (To unsubscribe, follow the
-  link in the footer of a message.)
+  … and receive new messages with your regular email.  (Use the `kwant-discuss options page <https://mailman-mail5.webfaction.com/options/kwant-discuss>`_ to unsubscribe.)
 
-- Read the list via the `Gmane web interface
-  <http://news.gmane.org/gmane.comp.science.kwant.user>`_.  The web interface
-  allows to write new messages (action: post) and to reply (action: followup).
-
-- .. raw:: html
-
-      <p><form id="searchgmane" method="get" action="http://search.gmane.org/">
-      <input type="text" size=25 name="query" />
-      <input type="hidden" name="group" value="gmane.comp.science.kwant.user" />
-      <input type="submit" value="Search the mailing list" />
-      </form></p>
+- Follow the list through a web interface: `kwant-discuss on Gmane <http://dir.gmane.org/gmane.comp.science.kwant.user>`_ or
+  `kwant-discuss on Mail-archive <https://www.mail-archive.com/kwant-discuss@kwant-project.org/>`_.
+  Gmane allows to write new messages (action: post) and to reply (action: followup).
+  Both Gmane and Mail-archive provide RSS feeds.
 
 - Send a message directly to kwant-discuss@kwant-project.org.  (If you are not
   subscribed, it is not guaranteed that any followups will reach you by email,
@@ -41,12 +41,16 @@ Announcements of new releases (low-volume)
 This read-only list is reserved for important announcements like new releases of
 Kwant.  Only a few messages will be sent per year.  These announcements will be also posted on the main mailing list, so there is no need to subscribe to both lists.  We recommend every user of Kwant to subscribe at least to this list in order to stay informed about new developments.
 
-.. raw:: html
+- View archives: `kwant-announce on Gmane <http://dir.gmane.org/gmane.comp.science.kwant.announce>`_ or `kwant-announce on Mail-archive <https://www.mail-archive.com/kwant-announce@kwant-project.org/>`_.  Both Gmane and Mail-archive provide RSS feeds.
+
+- .. raw:: html
+
+     <form method=post action="https://mailman-mail5.webfaction.com/subscribe/kwant-announce">
+     <input type="text" name="email" size=25 value="Your email address" onblur="if (this.value == '') {this.value='Your email address'}" onfocus="if (this.value == 'Your email address') {this.value=''}" />
+     <input type="submit" name="email-button" value="Subscribe to announcements" />
+     </form>
 
-   <form method=post action="https://mailman-mail5.webfaction.com/subscribe/kwant-announce">
-   <input type="text" name="email" size=25 value="Your email address" onblur="if (this.value == '') {this.value='Your email address'}" onfocus="if (this.value == 'Your email address') {this.value=''}" />
-   <input type="submit" name="email-button" value="Subscribe to announcements" />
-   </form>
+  (Use the `kwant-announce options page <https://mailman-mail5.webfaction.com/options/kwant-announce>`_ to unsubscribe.)
 
 
 Reporting bugs
-- 
GitLab