commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From nia...@apache.org
Subject svn commit: r931760 - /commons/proper/commons-site/trunk/src/site/xdoc/mail-lists.xml
Date Thu, 08 Apr 2010 02:58:38 GMT
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="dev@commons.apache.org">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:user-subscribe@commons.apache.org">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:dev-subscribe@commons.apache.org">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:issues-subscribe@commons.apache.org">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:commits-subscribe@commons.apache.org">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:announce-subscribe@apache.org">Subscribe</a>



Mime
View raw message