Commit 89be899a authored by Christoph Groth's avatar Christoph Groth
Browse files

rewrite mailing list sections of community page

parent 34ecb317
Pipeline #36842 passed with stage
in 36 seconds
...@@ -6,47 +6,60 @@ Everybody is welcome to participate in the community ...@@ -6,47 +6,60 @@ Everybody is welcome to participate in the community
by asking and replying to questions, reporting bugs, providing suggestions, by asking and replying to questions, reporting bugs, providing suggestions,
and `contributing to the code and documentation </contribute.html>`_. and `contributing to the code and documentation </contribute.html>`_.
The Kwant community uses three public communication channels:
the mailing list for generic discussions, questions, and announcements;
the gitlab instance for development discussions and reporting bugs;
and the chat for real-time discussions related to development.
A list of `Kwant authors </authors>`_ is included in the documentation. A list of `Kwant authors </authors>`_ is included in the documentation.
Please only contact the authors directly for matters that cannot be discussed in public on one of the mailing lists. Please contact the authors directly only for matters that cannot be discussed on the public channels.
Mailing list Mailing list
------------ ------------
The kwant-discuss mailing list is the main public communication platform for topics related to Kwant: The kwant-discuss mailing list is the main public communication platform for anything related to Kwant:
questions, discussions, development, and announcements. questions, discussions, development, and announcements.
It may be used both as a web forum and as a classical mailing list.
- The simplest way to send a message to the list is to write to
kwant-discuss@python.org. The `kwant-discuss web interface <https://mail.python.org/archives/list/kwant-discuss@python.org/>`_
If you are not subscribed, your message will be held for moderation. allows to follow discussions and search the archives.
When asking a question,
please follow the usual `recommendations for asking good questions <https://stackoverflow.com/help/how-to-ask>`_. To start a new discussion thread, you may either use the web interface
In particular, please make sure that the topic has not been covered already by searching: (sign-in required)
or write directly to
.. raw:: html kwant-discuss@python.org.
In order to avoid spam,
<form class="form-inline" method="get" action="https://mail.python.org/archives/search"> messages of unsubscribed participants are held for moderation.
<div class="input-group col-md-8">
<input type="hidden" name="mlist" value="kwant-discuss@python.org"> Similarly, replying is possible either by mail
<input type="text" class="form-control" placeholder="Search query" size=25 name="q"> (if you received the posting to which you want reply by mail),
<span class="input-group-btn"> or using the web interface:
<input class="btn btn-default" type="submit" value="Search kwant-discuss"> the “reply” button under each message allows to compose directly
</span> (for signed-in users),
</div> or triggers a reply by mail (otherwise).
</form>
You may subscribe to receive posts to the list by mail.
- You may subscribe to receive all posts to the list by email. Subscription is done either through the
(The volume is seldom more than a dozen messages per week.) `kwant-discuss info page
Subscription is done either through a form on the <https://mail.python.org/mailman3/lists/kwant-discuss.python.org/>`_
`kwant-discuss info page or by sending any message to
<https://mail.python.org/mailman3/lists/kwant-discuss.python.org/>`_ kwant-discuss-join@python.org.
or simply by sending anything (even an empty message) to (The subject and content are ignored and may be empty.)
kwant-discuss-join@python.org. To unsubscribe, either use the info page,
To unsubscribe, either use the info page, or send any message to kwant-discuss-leave@python.org.
or send any message to kwant-discuss-leave@python.org.
List etiquette :
- The list can be also used as a web forum: `kwant-discuss web interface
<https://mail.python.org/archives/list/kwant-discuss@python.org/>`_. - When asking questions,
`help others help you <https://stackoverflow.com/help/how-to-ask>`_.
In particular, use the search function before posting.
- Make sure that your post is reasonably formatted.
In particular, do not reply to digests (use the forum reply instead).
When replying, please avoid quoting the complete original message.
Instead, consider
`bottom-posting <https://en.wikipedia.org/wiki/Posting_style#Bottom-posting>`_.
Announcements mailing list Announcements mailing list
...@@ -58,13 +71,13 @@ These announcements are also posted on the main mailing list, ...@@ -58,13 +71,13 @@ These announcements are also posted on the main mailing list,
so there is no need to subscribe to both lists. 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. We recommend every user of Kwant to subscribe at least to this list in order to stay informed about new developments.
- Consult the `kwant-announce archives on the web <https://mail.python.org/archives/list/kwant-announce@python.org/latest>`_. The `kwant-announce archives <https://mail.python.org/archives/list/kwant-announce@python.org/>`_
are available on the web.
- There are two ways to subscribe: To subscribe, either use the form on the `kwant-announce info page <https://mail.python.org/mailman3/lists/kwant-announce.python.org/>`_
either use the form on the `kwant-announce info page <https://mail.python.org/mailman3/lists/kwant-announce.python.org/>`_ or simply send any message to kwant-announce-join@python.org.
or simply send any message to kwant-announce-join@python.org. (The subject and content are ignored and may be empty.)
(The subject and content are ignored and may be empty.) To unsubscribe, either use the info page, or send any message to kwant-announce-leave@python.org.
To unsubscribe, either use the the info page, or send any message to kwant-announce-leave@python.org.
Development chat Development chat
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment