Author: sebb
Date: Wed Apr 7 19:43:26 2010
New Revision: 931653
URL: http://svn.apache.org/viewvc?rev=931653&view=rev
Log:
Tweaks
Modified:
commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml
Modified: commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml
URL:
http://svn.apache.org/viewvc/commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml?rev=931653&r1=931652&r2=931653&view=diff
==============================================================================
--- commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml (original)
+++ commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml Wed Apr
7 19:43:26 2010
@@ -25,11 +25,10 @@
<body>
<section name="Commons Mailing Lists - Overview">
<p>
- Apache Commons uses shared mailing lists for all of its components.
- There is only one developer list, and one user list, so it is important
to identify the component name
- in the Subject line.
- This ensures that readers can quickly determine if the message is of
interest.
- The convention adopted by Commons is to start the Subject: line with
[component], for example:
+ Apache Commons uses shared mailing lists for all of its
+ <a href="http://commons.apache.org/components.html";
class="externalLink">components</a>.
+ To make it easier for people to only read messages related to components
they are interested in,
+ the convention adopted by Commons is to start the Subject: line with
[component], for example:
<ul>
<li>[EMAIL] Problem with mimemessage</li>
<li>[IO] Progress Monitor</li>
@@ -37,22 +36,28 @@
</ul>
If the mail applies to two components, use both prefixes, e.g.
<code>[IO][NET]</code>.
</p>
- <p>
- Other prefixes which may be used are:
- <ul>
- <li>[ALL] - general discussion (developer list)</li>
- <li>[DOC] - Documentation discussion</li>
- <li>[jira] - this is automatically added by JIRA messages
(issues list)</li>
- <li>[VOTE], [RESULT], [CANCELLED] - voting threads (developer
list)</li>
- <li>[ANNOUNCE], [ANN] - announcements of releases etc.</li>
- </ul>
- </p>
+ <p>
+ The <b>Commons User</b> list is the best list for all questions about
Commons components.
+ <br />
+ Commons developers are subscribed to the list, and will do their best to
+ provide an answer. Please use a descriptive subject line and remember to
+ include the [component] prefix.
+ </p>
+ <p>
+ Note: please don't send patches or attachments to any of the mailing lists.
+ Patches are best handled through JIRA, see:
+ <a href="patches.html#Submitting_A_Patch">Submitting a patch</a>
+ JIRA can also be used for attachments related to a bug / enhancement
report.
+ Otherwise, please upload the file to a public server and include the URL
in the mail.
+ </p>
</section>
<section name="Commons Mailing Lists">
<p>
- This section lists the Commons mailing Lists.
- Please remember that these are shared, so use the appropriate prefix as
described above.
+ This section lists the Commons mailing Lists.
+ </p>
+ <p>
+ <strong>Please start the subject line with: <i>[component]</i></strong> -
<i>thanks!</i>
</p>
<table class="bodyTable">
<tbody>
@@ -137,7 +142,7 @@
<td>
<a class="externalLink"
href="mailto:[email protected]";>Unsubscribe</a>
</td>
- <td>Not applicable</td>
+ <td><i>read only</i></td>
<td>
<a class="externalLink"
href="http://mail-archives.apache.org/mod_mbox/commons-issues/";>mail-archives.apache.org</a>
@@ -165,7 +170,7 @@
<td>
<a class="externalLink"
href="mailto:[email protected]";>Unsubscribe</a>
</td>
- <td>Not applicable</td>
+ <td><i>read only</i></td>
<td>
<a class="externalLink"
href="http://mail-archives.apache.org/mod_mbox/commons-commits/";>mail-archives.apache.org</a>
@@ -220,5 +225,17 @@
</tbody>
</table>
</section>
+ <section name="Other subject prefixes">
+ <p>
+ Other prefixes which may be used on Commons mailing lists are:
+ <ul>
+ <li>[ALL] - general discussion (developer list)</li>
+ <li>[DOC] - Documentation discussion</li>
+ <li>[jira] - this is automatically added by JIRA messages (issues
list)</li>
+ <li>[VOTE], [RESULT], [CANCELLED] - voting threads (developer
list)</li>
+ <li>[ANNOUNCE], [ANN] - announcements of releases etc.</li>
+ </ul>
+ </p>
+ </section>
</body>
</document>
