Author: niallp
Date: Thu Apr 8 02:58:37 2010
New Revision: 931760
URL: http://svn.apache.org/viewvc?rev=931760&view=rev
Log:
Improve wording/make more succinct
Modified:
commons/proper/commons-site/trunk/src/site/xdoc/mail-lists.xml
Modified: commons/proper/commons-site/trunk/src/site/xdoc/mail-lists.xml
URL:
http://svn.apache.org/viewvc/commons/proper/commons-site/trunk/src/site/xdoc/mail-lists.xml?rev=931760&r1=931759&r2=931760&view=diff
==============================================================================
--- commons/proper/commons-site/trunk/src/site/xdoc/mail-lists.xml (original)
+++ commons/proper/commons-site/trunk/src/site/xdoc/mail-lists.xml Thu Apr 8
02:58:37 2010
@@ -23,12 +23,12 @@
<author email="[email protected]">The Apache Commons Team</author>
</properties>
<body>
- <section name="Commons Mailing Lists - Overview">
+ <section name="Overview">
<p>
- Apache Commons uses shared mailing lists for all of its
- <a href="http://commons.apache.org/components.html";>components</a>.
+ Apache Commons uses shared mailing lists for all of its <a
href="components.html">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:
+ the convention in Commons is to prefix the subject line of messages with
the component's name,
+ for example:
<ul>
<li>[EMAIL] Problem with mime message</li>
<li>[IO] Progress Monitor</li>
@@ -36,30 +36,20 @@
</ul>
</p>
<p>
- If the mail applies to two components, use both prefixes, e.g.
<code>[IO][NET]</code>.
+ The <b>Developer</b> list is for questions and discussion related to the
+ development of Commons components. Questions related to the usage of
Commons
+ components should be posted to the <b>User</b> list.
</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.
+ <strong>Note:</strong> please don't send patches or attachments to any
of the mailing lists.
+ Patches are best handled via the <i>Issue Tracking</i> system.
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.
- </p>
- <p>
- <strong>Please start the subject line with: <i>[component]</i></strong>
- <i>thanks!</i>
+ <strong>Please prefix the subject line of any messages with:
<i>[component]</i></strong> - <i>thanks!</i>
<br />
<br />
</p>
@@ -78,9 +68,9 @@
<tr>
<td>
<b>Commons User List</b>
- <br></br><br></br>
- General usage questions on Commons components.
- Medium traffic.
+ <br /><br />
+ Questions on using Commons components.
+ <br /><br />
</td>
<td>
<a href="mailto:[email protected]";>Subscribe</a>
@@ -108,9 +98,9 @@
<tr>
<td>
<b>Commons Developer List</b>
- <br></br><br></br>
- This mailing list is used by Commons developers to discuss code,
vote on releases etc.
- High traffic.
+ <br /><br />
+ Discussion of development of Commons components.
+ <br /><br />
</td>
<td>
<a href="mailto:[email protected]";>Subscribe</a>
@@ -138,9 +128,9 @@
<tr>
<td>
<b>Commons Issues List</b>
- <br></br><br></br>
- This list is only for e-mails generated by JIRA, the issue
tracking system used by Apache Commons.
- High traffic.
+ <br /><br />
+ Only for e-mails generated by the <i>issue tracking</i> system.
+ <br /><br />
</td>
<td>
<a href="mailto:[email protected]";>Subscribe</a>
@@ -164,10 +154,9 @@
<tr>
<td>
<b>Commons Commits List</b>
- <br></br><br></br>
- This list is only for e-mails automatically generated by SVN,
- the source code control sytem used by Apache Commons.
- High traffic.
+ <br /><br />
+ Only for e-mails automatically generated by the <i>source
control</i> sytem.
+ <br /><br />
</td>
<td>
<a href="mailto:[email protected]";>Subscribe</a>
@@ -206,8 +195,9 @@
<tr>
<td>
<b>Apache Announce List</b>
- <br></br><br></br>
- General announcements of Apache project releases. Low traffic.
+ <br /><br />
+ General announcements of Apache project releases.
+ <br /><br />
</td>
<td>
<a href="mailto:[email protected]";>Subscribe</a>
