docutils/docs/user/mailing-lists.txt

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