docutils/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 .. raw:: html
  13
  14    <div class="sidebar">
  15    <p class="first sidebar-title">Search the list archives</p>
  16    <form method="get" action="https://sourceforge.net/p/docutils/mailman/search/">
  17    <p style="margin-bottom: 3px;"><input type="text" name="q" style="width: 100%;" /></p>
  18    <p>Search in <select name="mail_list">
  19        <option value="all">all mailing lists</option>
  20        <option value="docutils-users">Docutils-users</option>
  21        <option value="docutils-develop">Docutils-develop</option>
  22        <option value="docutils-checkins">Docutils-checkins</option>
  23        </select></p>
  24    <p class="last"><input type="submit" value="Search" /></p>
  25    </form>
  26    </div>
  27
  28 All discussion about Docutils takes place on mailing lists.
  29
  30 There are four different lists with traffic related to Docutils.
  31 For an oversight, see https://sourceforge.net/p/docutils/mailman/.
  32 If unsure, use the **Docutils-users** mailing list:
  33
  34
  35 Docutils-users
  36 --------------
  37
  38 The `Docutils-users mailing list`_ is a place to discuss any issues
  39 related to the usage of Docutils and reStructuredText.  (Please be
  40 sure to check the FAQ_ first.)
  41
  42 There are several possibilities to **read and post** messages on the
  43 mailing lists; use the one you feel most comfortable with.
  44
  45 * Using an `email subscription`__.  This is the traditional way; you
  46   will receive all messages sent to the mailing list via email.
  47
  48   __ `docutils-users mailing list`_
  49
  50 * **If you do not wish to subscribe,** you can also just send an email
  51   message with your question or comment to
  52   Docutils-users@lists.sourceforge.net.
  53
  54   Note in your message that you are not subscribed (to make sure that you
  55   receive copies [CCs] of any replies) or check for answers in the
  56   `Docutils-users Archives`_.
  57
  58 The first time you post a message without being subscribed
  59 you will receive an automatic response with the subject
  60 "Your message to Docutils-users awaits moderator approval"; this is done to
  61 prevent spam to the mailing lists.  Your message will usually be approved
  62 within a few hours.  To avoid duplicates, please do not resend your message
  63 using a different email address.  After your first message has been
  64 approved, your email address will be added to the whitelist and future
  65 messages will be posted to the mailing list without moderation.
  66
  67 To see the collection of prior postings to the list, visit the
  68 `Docutils-users Archives`_.
  69
  70
  71 Docutils-develop
  72 ----------------
  73
  74 Discussions about developing and extending Docutils take place on the
  75 `Docutils-develop mailing list`_.
  76
  77 You can access this list via `email subscription`__ the posting address is
  78 Docutils-develop@lists.sourceforge.net.
  79
  80 To see the collection of prior postings to the list, visit the
  81 `Docutils-develop Archives`__.
  82
  83 __ `Docutils-develop mailing list`_
  84 __ https://sourceforge.net/p/docutils/mailman/docutils-develop
  85
  86 Docutils-checkins
  87 -----------------
  88
  89 All check-ins to the `Subversion repository`_ cause a "check-in email"
  90 to the `Docutils-checkins list`_.  In order to stay informed about
  91 current development, developers are advised to monitor this mailing
  92 list.
  93
  94 This mailing list is for reading only; please direct any discussion
  95 about the check-ins to Docutils-develop.  (For your convenience, the
  96 Reply-To header of all check-in emails points to Docutils-develop.)
  97
  98 This mailing list is accessible via `email subscription`__.
  99
 100 __ `Docutils-checkins list`_
 101 __ https://sourceforge.net/p/docutils/mailman/docutils-checkins
 102
 103 Doc-SIG
 104 -------
 105
 106 The "Python Documentation Special Interest Group" (`Doc-SIG`_) mailing list
 107 is occasionally used to discuss the usage of Docutils for Python
 108 documentation.
 109
 110 This mailing list can be accessed via `email subscription`__.  You must be
 111 subscribed in order to post messages to this mailing list.
 112
 113 .. _Docutils-users mailing list:
 114    http://lists.sourceforge.net/lists/listinfo/docutils-users
 115 .. _Docutils-users Archives:
 116    http://sourceforge.net/mailarchive/forum.php?forum_name=docutils-users
 117 .. _Docutils-develop mailing list:
 118    http://lists.sourceforge.net/lists/listinfo/docutils-develop
 119 .. _Docutils-develop Archives:
 120    http://sourceforge.net/mailarchive/forum.php?forum_name=docutils-develop
 121 .. _Docutils-checkins list:
 122    http://lists.sourceforge.net/lists/listinfo/docutils-checkins
 123 .. _Doc-SIG:
 124    http://mail.python.org/mailman/listinfo/doc-sig
 125
 126 .. _Subversion repository: ../dev/repository.html
 127 .. _Docutils: http://docutils.sourceforge.net/
 128 .. _FAQ: ../../FAQ.html