streamline mailing list information

content/community.rst

@@ -15,11 +15,17 @@ Mailing list
 ------------
 
 The kwant-discuss mailing list is the main public communication platform for
-anything related to Kwant: questions, discussions, development, and
-announcements.  (Bug reports may be also sent, but the preferred way is
-described further below on this page.)  You can use it in various ways:
+topics related to Kwant: questions, discussions, development, and
+announcements.
 
-- .. raw:: html
+- The simplest way to send a message to the list is to write to
+  kwant-discuss@python.org.
+  If you are not subscribed, your message will be held for moderation.
+  When asking a question,
+  please follow the usual `recommendations for asking good questions <https://stackoverflow.com/help/how-to-ask>`_.
+  In particular, please make sure that the topic has not been covered already by searching:
+
+  .. raw:: html
 
     <form class="form-inline"  method="get" action="https://mail.python.org/archives/search">
     <div class="input-group col-md-8">
@@ -31,43 +37,18 @@ described further below on this page.)  You can use it in various ways:
     </div>
     </form>
 
-- To subscribe and receive new messages by email: either use the form on the
+- You may subscribe to receive all posts to the list by email.
+  (The volume is seldom more than a dozen messages per week.)
+  Subscription is done either through a form on the
   `kwant-discuss info page
   <https://mail.python.org/mailman3/lists/kwant-discuss.python.org/>`_
-  or simply send
-  a message to kwant-discuss-join@python.org.  (The subject and content
-  are ignored and may be empty.)  To unsubscribe, either use the form at the
-  bottom of the info page, or send any message to
-  kwant-discuss-leave@python.org.
-
-- Consult the `kwant-discuss archives on the web
-  <https://mail.python.org/archives/list/kwant-discuss@python.org/latest>`_.
-
-- Whether you are subscribed or not, you may post to the list simply by sending
-  email to kwant-discuss@python.org.  If you are not subscribed, the message will be held for moderation.
-
-- Please do not hesitate to join the discussion.  It’s easy to reply to a
-  posting even if you are not subscribed (or receiving digests):
-  Simply click on the button “Reply” at the bottom of a posting.
-
-- In May 2020, thanks to the friendly people at python.org, kwant-discuss was migrated to a Mailman 3 server that offers a much-improved web interface.  The complete archives of the list were migrated as well.  The `old address of the list <kwant-discuss@kwant-project.org>`_ remains usable: any messages are simply redirected to the new one.
-
-The `Kwant development mailing list
-<https://mailman-mail5.webfaction.com/listinfo/kwant-devel>`_ has been retired
-in 2019.  Please use the main list instead, or the other communication channels
-listed below (chat and gitlab). The archives of kwant-devel remain searchable:
-
-.. raw:: html
+  or simply by sending anything (even an empty message) to
+  kwant-discuss-join@python.org.
+  To unsubscribe, either use the info page,
+  or send any message to kwant-discuss-leave@python.org.
 
-  <form class="form-inline"  method="get" action="https://www.mail-archive.com/search">
-  <div class="input-group col-md-8">
-  <input type="text" class="form-control" placeholder="Search query" size=25 name="q">
-  <input type="hidden" name="l" value="kwant-devel@kwant-project.org">
-  <span class="input-group-btn">
-  <input class="btn btn-default" type="submit" value="Search kwant-devel">
-  </span>
-  </div>
-  </form>
+- The list can be also used as a web forum: `kwant-discuss web interface
+  <https://mail.python.org/archives/list/kwant-discuss@python.org/>`_.
 
 
 Announcements mailing list
@@ -82,8 +63,7 @@ Kwant.  Only a few messages are sent per year.  These announcements are also pos
   info page <https://mail.python.org/mailman3/lists/kwant-announce.python.org/>`_ or
   simply send any message to kwant-announce-join@python.org.  (The subject
   and content are ignored and may be empty.)  To unsubscribe, either use the
-  form at the bottom of the info page, or send any message to
-  kwant-announce-leave@python.org.
+  the info page, or send any message to kwant-announce-leave@python.org.
 
 
 Development chat