summaryrefslogtreecommitdiff
path: root/docs/user/mailing-lists.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/user/mailing-lists.txt')
-rw-r--r--docs/user/mailing-lists.txt111
1 files changed, 111 insertions, 0 deletions
diff --git a/docs/user/mailing-lists.txt b/docs/user/mailing-lists.txt
new file mode 100644
index 000000000..8137e29e7
--- /dev/null
+++ b/docs/user/mailing-lists.txt
@@ -0,0 +1,111 @@
+=========================
+ Docutils_ Mailing Lists
+=========================
+
+:Author: Felix Wiemann
+:Contact: Felix.Wiemann@ososo.de
+:Revision: $Revision$
+:Date: $Date$
+:Copyright: This document has been placed in the public domain.
+
+
+All discussion about Docutils takes place on mailing lists.
+
+There are four different lists with traffic related to Docutils. If
+unsure, use the **Docutils-users** mailing list:
+
+
+Docutils-users
+--------------
+
+The Docutils-users mailing list is a place to discuss any issues
+related to the usage of Docutils and reStructuredText. (Please be
+sure to check the FAQ_ first.)
+
+There are three possibilities to **read and post** messages on the
+mailing lists; use the one you feel most comfortable with.
+
+* Using an `email subscription`__. This is the traditional way; you
+ will receive all messages sent to the mailing list via email.
+
+ __ http://lists.sourceforge.net/lists/listinfo/docutils-users
+
+* Using Gmane's `web interface`__. To post a message, click "post" or
+ "followup" in the drop-down menu on the right.
+
+ __ http://news.gmane.org/gmane.text.docutils.user
+
+* If you prefer using a newsreader, you can also use Gmane's `NNTP
+ interface`__ (gmane.text.docutils.user on news.gmane.org).
+
+ __ nntp://news.gmane.org/gmane.text.docutils.user.
+
+**If you do not wish to subscribe,** you can also just send an email
+message to Docutils-users@lists.sourceforge.net. Please note in your
+message that you are not subscribed (to make sure that you receive
+copies [CCs] of any replies).
+
+The first time you post a message without being subscribed (also when
+posting via Gmane), you will receive an automatic response with the
+subject "Your message to Docutils-users awaits moderator approval";
+this is done to prevent spam to the mailing lists. Your message will
+usually be approved within a few hours. To avoid duplicates, please
+do not resend your message using a different email address. After
+your first message has been approved, your email address will be added
+to the whitelist and future messages will be posted to the mailing
+list without moderation.
+
+
+Doc-SIG
+-------
+
+The "Python Documentation Special Interest Group" (Doc-SIG) mailing
+list is occasionally used to discuss the usage of Docutils for Python
+documentation.
+
+This mailing list can be accessed via `email subscription`__, web__ or
+news__ (gmane.comp.python.documentation) as well. You must be
+subscribed in order to post messages to this mailing list.
+
+__ http://mail.python.org/mailman/listinfo/doc-sig
+__ http://news.gmane.org/gmane.comp.python.documentation
+__ nntp://news.gmane.org/gmane.comp.python.documentation
+
+
+Docutils-develop
+----------------
+
+Discussions about developing and extending Docutils take place on the
+Docutils-develop mailing list.
+
+You can access this list via `email subscription`__, web__ or news__
+(gmane.text.docutils.devel); the posting address is
+Docutils-develop@lists.sourceforge.net.
+
+__ http://lists.sourceforge.net/lists/listinfo/docutils-develop
+__ http://news.gmane.org/gmane.text.docutils.devel
+__ nntp://news.gmane.org/gmane.text.docutils.devel
+
+
+Docutils-checkins
+-----------------
+
+All check-ins to the `Subversion repository`_ cause a "check-in email"
+to the Docutils-checkins list. In order to stay informed about
+current development, developers are advised to monitor this mailing
+list.
+
+This mailing list is for reading only; please direct any discussion
+about the check-ins to Docutils-develop. (For your convenience, the
+Reply-To header of all check-in emails points to Docutils-develop.)
+
+This mailing list is accessible via `email subscription`__, web__ or
+news__ (gmane.text.docutils.cvs) as well.
+
+__ http://lists.sourceforge.net/lists/listinfo/docutils-checkins
+__ http://news.gmane.org/gmane.text.docutils.cvs
+__ nntp://news.gmane.org/gmane.text.docutils.cvs
+
+.. _Subversion repository: http://docutils.sf.net/docs/dev/repository.html
+.. _Docutils: http://docutils.sourceforge.net/
+.. _FAQ: http://docutils.sourceforge.net/FAQ.html