docs/user/mailing-lists.txt

   1 =========================
   2  Docutils_ Mailing Lists
   3 =========================
   4
   5 :Author: Lea Wiemann
   6 :Contact: docutils-develop@lists.sourceforge.net
   7 :Revision: $Revision$
   8 :Date: $Date$
   9 :Copyright: This document has been placed in the public domain.
  10
  11
  12 .. Gmane went down 2016 and is only partially restored.
  13    http://home.gmane.org/2016/08/29/next-steps-gmane/
  14
  15 .. raw:: html
  16
  17    https://sourceforge.net/p/docutils/mailman/search/?mail_list=docutils-checkins
  18                                                              all
  19
  20    <div class="sidebar">
  21    <p class="first sidebar-title">Search the list archives</p>
  22    <form method="get" action="https://sourceforge.net/p/docutils/mailman/search/">
  23    <p style="margin-bottom: 3px;"><input type="text" name="q" style="width: 100%;" /></p>
  24    <p>Search in <select name="mail_list">
  25        <option value="all">all mailing lists</option>
  26        <option value="docutils-users">Docutils-users</option>
  27        <option value="docutils-develop">Docutils-develop</option>
  28        <option value="docutils-checkins">Docutils-checkins</option>
  29        </select></p>
  30    <p class="last"><input type="submit" value="Search" /></p>
  31    </form>
  32    </div>
  33
  34 All discussion about Docutils takes place on mailing lists.
  35
  36 There are four different lists with traffic related to Docutils.
  37 For an oversight, see https://sourceforge.net/p/docutils/mailman/.
  38 If unsure, use the **Docutils-users** mailing list:
  39
  40
  41 Docutils-users
  42 --------------
  43
  44 The `Docutils-users mailing list`_ is a place to discuss any issues
  45 related to the usage of Docutils and reStructuredText.  (Please be
  46 sure to check the FAQ_ first.)
  47
  48 There are several possibilities to **read and post** messages on the
  49 mailing lists; use the one you feel most comfortable with.
  50
  51 * Using an `email subscription`__.  This is the traditional way; you
  52   will receive all messages sent to the mailing list via email.
  53
  54   __ `docutils-users mailing list`_
  55
  56 .. * Using Gmane's `web interface`__.  To post a message, click "post" or
  57   "followup" in the drop-down menu on the right.  (Gmane also has a
  58   complete **archive** of the mailing list; use the search form at the
  59   top of this page to search it.)
  60
  61   __ http://news.gmane.org/gmane.text.docutils.user
  62
  63 * Use a newsreader with Gmane's `NNTP interface`__
  64   (gmane.text.docutils.user on news.gmane.org).
  65
  66   __ nntp://news.gmane.org/gmane.text.docutils.user
  67
  68 * **If you do not wish to subscribe,** you can also just send an email
  69   message with your question or comment to
  70   Docutils-users@lists.sourceforge.net.
  71
  72   Note in your message that you are not subscribed (to make sure that you
  73   receive copies [CCs] of any replies) or check for answers in the
  74   `Docutils-users Archives`_.
  75
  76 The first time you post a message without being subscribed (also when
  77 posting via Gmane), you will receive an automatic response with the subject
  78 "Your message to Docutils-users awaits moderator approval"; this is done to
  79 prevent spam to the mailing lists.  Your message will usually be approved
  80 within a few hours.  To avoid duplicates, please do not resend your message
  81 using a different email address.  After your first message has been
  82 approved, your email address will be added to the whitelist and future
  83 messages will be posted to the mailing list without moderation.
  84
  85 To see the collection of prior postings to the list, visit the
  86 `Docutils-users Archives`_.
  87
  88
  89 Docutils-develop
  90 ----------------
  91
  92 Discussions about developing and extending Docutils take place on the
  93 `Docutils-develop mailing list`_.
  94
  95 You can access this list via `email subscription`__ or news__
  96 (gmane.text.docutils.devel); the posting address is
  97 Docutils-develop@lists.sourceforge.net.
  98
  99 To see the collection of prior postings to the list, visit the
 100 `Docutils-develop Archives`__.
 101
 102 __ `Docutils-develop mailing list`_
 103 __ nntp://news.gmane.org/gmane.text.docutils.devel
 104 __ http://sourceforge.net/mailarchive/forum.php?forum_name=docutils-develop
 105
 106 Docutils-checkins
 107 -----------------
 108
 109 All check-ins to the `Subversion repository`_ cause a "check-in email"
 110 to the `Docutils-checkins list`_.  In order to stay informed about
 111 current development, developers are advised to monitor this mailing
 112 list.
 113
 114 This mailing list is for reading only; please direct any discussion
 115 about the check-ins to Docutils-develop.  (For your convenience, the
 116 Reply-To header of all check-in emails points to Docutils-develop.)
 117
 118 This mailing list is accessible via `email subscription`__ or
 119 news__ (gmane.text.docutils.cvs) as well.
 120
 121 If you are using an email subscription and you would prefer to only
 122 receive check-in messages for changes that affect the main Docutils
 123 distribution (i.e. ``trunk/docutils/*``), go to the `list options`_
 124 page and select the "Docutils core" topic.
 125
 126 __ `Docutils-checkins list`_
 127 __ nntp://news.gmane.org/gmane.text.docutils.cvs
 128 .. _list options: http://lists.sf.net/lists/options/docutils-checkins
 129
 130 Doc-SIG
 131 -------
 132
 133 The "Python Documentation Special Interest Group" (`Doc-SIG`_) mailing list
 134 is occasionally used to discuss the usage of Docutils for Python
 135 documentation.
 136
 137 This mailing list can be accessed via `email subscription`__ or
 138 news__ (gmane.comp.python.documentation) as well.  You must be
 139 subscribed in order to post messages to this mailing list.
 140
 141 __ `Doc-SIG`_
 142 __ nntp://news.gmane.org/gmane.comp.python.documentation
 143
 144
 145 .. _Docutils-users mailing list:
 146    http://lists.sourceforge.net/lists/listinfo/docutils-users
 147 .. _Docutils-users Archives:
 148    http://sourceforge.net/mailarchive/forum.php?forum_name=docutils-users
 149 .. _Docutils-develop mailing list:
 150    http://lists.sourceforge.net/lists/listinfo/docutils-develop
 151 .. _Docutils-develop Archives:
 152    http://sourceforge.net/mailarchive/forum.php?forum_name=docutils-develop
 153 .. _Docutils-checkins list:
 154    http://lists.sourceforge.net/lists/listinfo/docutils-checkins
 155 .. _Doc-SIG:
 156    http://mail.python.org/mailman/listinfo/doc-sig
 157
 158 .. _Subversion repository: ../dev/repository.html
 159 .. _Docutils: http://docutils.sourceforge.net/
 160 .. _FAQ: ../../FAQ.html