docs/user/mailing-lists.txt

   1 =========================
   2  Docutils_ Mailing Lists
   3 =========================
   4
   5 :Author: Lea Wiemann
   6 :Contact: LeWiemann@gmail.com
   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 on Gmane</p>
  16    <form method="get" action="http://search.gmane.org/">
  17    <p style="margin-bottom: 3px;"><input type="text" name="query" style="width: 100%;" /></p>
  18    <p>Search in <select name="group">
  19        <option value="gmane.text.docutils.*">all mailing lists</option>
  20        <option value="gmane.text.docutils.user">Docutils-users</option>
  21        <option value="gmane.text.docutils.devel">Docutils-develop</option>
  22        <option value="gmane.text.docutils.cvs">Docutils-checkins</option>
  23        <option value="gmane.comp.python.documentation">Doc-SIG</option>
  24        </select></p>
  25    <p>Sort by <select name="sort">
  26        <option value="relevance">relevance</option>
  27        <option value="date">date (newest first)</option>
  28        <option value="revdate">date (oldest first)</option></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.  If
  36 unsure, use the **Docutils-users** mailing list:
  37
  38
  39 Docutils-users
  40 --------------
  41
  42 The Docutils-users mailing list is a place to discuss any issues
  43 related to the usage of Docutils and reStructuredText.  (Please be
  44 sure to check the FAQ_ first.)
  45
  46 There are three possibilities to **read and post** messages on the
  47 mailing lists; use the one you feel most comfortable with.
  48
  49 * Using an `email subscription`__.  This is the traditional way; you
  50   will receive all messages sent to the mailing list via email.
  51
  52   __ http://lists.sourceforge.net/lists/listinfo/docutils-users
  53
  54 * Using Gmane's `web interface`__.  To post a message, click "post" or
  55   "followup" in the drop-down menu on the right.  (Gmane also has a
  56   complete **archive** of the mailing list; use the search form at the
  57   top of this page to search it.)
  58
  59   __ http://news.gmane.org/gmane.text.docutils.user
  60
  61 * If you prefer to use a newsreader, you can also use Gmane's `NNTP
  62   interface`__ (gmane.text.docutils.user on news.gmane.org).
  63
  64   __ nntp://news.gmane.org/gmane.text.docutils.user.
  65
  66 **If you do not wish to subscribe,** you can also just send an email
  67 message with your question or comment to
  68 Docutils-users@lists.sourceforge.net.  Please note in your message
  69 that you are not subscribed (to make sure that you receive copies
  70 [CCs] of any replies).
  71
  72 The first time you post a message without being subscribed (also when
  73 posting via Gmane), you will receive an automatic response with the
  74 subject "Your message to Docutils-users awaits moderator approval";
  75 this is done to prevent spam to the mailing lists.  Your message will
  76 usually be approved within a few hours.  To avoid duplicates, please
  77 do not resend your message using a different email address.  After
  78 your first message has been approved, your email address will be added
  79 to the whitelist and future messages will be posted to the mailing
  80 list without moderation.
  81
  82
  83 Docutils-develop
  84 ----------------
  85
  86 Discussions about developing and extending Docutils take place on the
  87 Docutils-develop mailing list.
  88
  89 You can access this list via `email subscription`__, web__ or news__
  90 (gmane.text.docutils.devel); the posting address is
  91 Docutils-develop@lists.sourceforge.net.
  92
  93 __ http://lists.sourceforge.net/lists/listinfo/docutils-develop
  94 __ http://news.gmane.org/gmane.text.docutils.devel
  95 __ nntp://news.gmane.org/gmane.text.docutils.devel
  96
  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`__, web__ 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 __ http://lists.sourceforge.net/lists/listinfo/docutils-checkins
 119 __ http://news.gmane.org/gmane.text.docutils.cvs
 120 __ nntp://news.gmane.org/gmane.text.docutils.cvs
 121 .. _list options: http://lists.sf.net/lists/options/docutils-checkins
 122
 123 Doc-SIG
 124 -------
 125
 126 The "Python Documentation Special Interest Group" (Doc-SIG) mailing
 127 list is occasionally used to discuss the usage of Docutils for Python
 128 documentation.
 129
 130 This mailing list can be accessed via `email subscription`__, web__ or
 131 news__ (gmane.comp.python.documentation) as well.  You must be
 132 subscribed in order to post messages to this mailing list.
 133
 134 __ http://mail.python.org/mailman/listinfo/doc-sig
 135 __ http://news.gmane.org/gmane.comp.python.documentation
 136 __ nntp://news.gmane.org/gmane.comp.python.documentation
 137
 138
 139 .. _Subversion repository: ../dev/repository.html
 140 .. _Docutils: http://docutils.sourceforge.net/
 141 .. _FAQ: ../../FAQ.html