You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by se...@apache.org on 2010/04/07 14:17:26 UTC

svn commit: r931515 - /commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml

Author: sebb
Date: Wed Apr  7 12:17:25 2010
New Revision: 931515

URL: http://svn.apache.org/viewvc?rev=931515&view=rev
Log:
Initial version of generic mailing list page.
Not yet included in navigation links.

Added:
    commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml   (with props)

Added: 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=931515&view=auto
==============================================================================
--- commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml (added)
+++ commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml Wed Apr  7 12:17:25 2010
@@ -0,0 +1,224 @@
+<?xml version="1.0" ?>
+<!-- $Id: $ -->
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+   
+         http://www.apache.org/licenses/LICENSE-2.0
+   
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+
+<document>
+ <properties>
+  <title>Commons Mailing Lists</title>
+  <author email="dev@commons.apache.org">The Apache Commons Team</author>
+ </properties>
+ <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:
+	<ul>
+	<li>[EMAIL] Problem with mimemessage</li>
+	<li>[IO] Progress Monitor</li>
+	<li>[VFS] Public key authentication support for sftp</li>
+	</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>
+  </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.
+    </p>
+<table class="bodyTable">
+	<tbody>
+		<tr class="a">
+			<th>Name</th>
+			<th>Subscribe</th>
+			<th>Unsubscribe</th>
+			<th>Post</th>
+			<th>Apache Archive</th>
+			<th>Other Archives</th>
+		</tr>
+		<tr class="b">
+			<td>
+			<b>Commons User List</b>
+            <br></br><br></br>
+            General usage questions on Commons components.
+            Medium traffic.
+			</td>
+			<td>
+				<a class="externalLink" href="mailto:user-subscribe@commons.apache.org">Subscribe</a>
+			</td>
+			<td>
+				<a class="externalLink" href="mailto:user-unsubscribe@commons.apache.org">Unsubscribe</a>
+			</td>
+			<td>
+				<a class="externalLink" href="mailto:user@commons.apache.org">Post</a>
+			</td>
+			<td>
+				<a class="externalLink" href="http://mail-archives.apache.org/mod_mbox/commons-user/">mail-archives.apache.org</a>
+			</td>
+			<td>
+				<a class="externalLink" href="http://markmail.org/list/org.apache.commons.users/">markmail.org</a>
+                <br></br>
+                <a class="externalLink" href="http://old.nabble.com/Commons---User-f319.html">old.nabble.com</a>
+                <br></br>
+                <a class="externalLink" href="http://www.mail-archive.com/user@commons.apache.org/">www.mail-archive.com</a>
+                <br></br>
+                <a class="externalLink" href="http://news.gmane.org/gmane.comp.jakarta.commons.user">news.gmane.org</a>
+			</td>
+		</tr>
+		<tr class="b">
+			<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.
+			</td>
+			<td>
+				<a class="externalLink" href="mailto:dev-subscribe@commons.apache.org">Subscribe</a>
+			</td>
+			<td>
+				<a class="externalLink" href="mailto:dev-unsubscribe@commons.apache.org">Unsubscribe</a>
+			</td>
+			<td>
+				<a class="externalLink" href="mailto:dev@commons.apache.org">Post</a>
+			</td>
+			<td>
+				<a class="externalLink" href="http://mail-archives.apache.org/mod_mbox/commons-dev/">mail-archives.apache.org</a>
+			</td>
+			<td>
+				<a class="externalLink" href="http://markmail.org/list/org.apache.commons.dev/">markmail.org</a>
+                <br></br>
+                <a class="externalLink" href="http://old.nabble.com/Commons---Dev-f317.html">old.nabble.com</a>
+                <br></br>
+                <a class="externalLink" href="http://www.mail-archive.com/dev@commons.apache.org/">www.mail-archive.com</a>
+                <br></br>
+                <a class="externalLink" href="http://news.gmane.org/gmane.comp.jakarta.commons.devel">news.gmane.org</a>
+			</td>
+
+		</tr>
+		<!-- TODO - list commons-private? -->
+		<tr class="b">
+			<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.
+			</td>
+			<td>
+				<a class="externalLink" href="mailto:issues-subscribe@commons.apache.org">Subscribe</a>
+			</td>
+			<td>
+				<a class="externalLink" href="mailto:issues-unsubscribe@commons.apache.org">Unsubscribe</a>
+			</td>
+			<td>Not applicable</td>
+			<td>
+				<a class="externalLink"
+					href="http://mail-archives.apache.org/mod_mbox/commons-issues/">mail-archives.apache.org</a>
+			</td>
+			<td>
+				<a class="externalLink" href="http://markmail.org/list/org.apache.commons.issues/">markmail.org</a>
+                <br></br>
+                <a class="externalLink" href="http://old.nabble.com/Commons---Issues-f25499.html">old.nabble.com</a>
+                <br></br>
+                <a class="externalLink" href="http://www.mail-archive.com/issues@commons.apache.org/">www.mail-archive.com</a>
+			</td>
+
+		</tr>
+		<tr class="a">
+			<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.
+			</td>
+			<td>
+				<a class="externalLink" href="mailto:commits-subscribe@commons.apache.org">Subscribe</a>
+			</td>
+			<td>
+				<a class="externalLink" href="mailto:commits-unsubscribe@commons.apache.org">Unsubscribe</a>
+			</td>
+			<td>Not applicable</td>
+			<td>
+				<a class="externalLink"
+					href="http://mail-archives.apache.org/mod_mbox/commons-commits/">mail-archives.apache.org</a>
+			</td>
+			<td>
+				<a class="externalLink" href="http://markmail.org/list/org.apache.commons.commits/">markmail.org</a>
+                <br></br>
+                <a class="externalLink" href="http://www.mail-archive.com/commits@commons.apache.org/">www.mail-archive.com</a>
+			</td>
+		</tr>
+	</tbody>
+</table>
+  </section>
+  <section name="Apache Mailing Lists">
+    <p>
+    Other mailing lists which you may find useful are:
+    </p>
+<table class="bodyTable">
+    <tbody>
+        <tr class="a">
+            <th>Name</th>
+            <th>Subscribe</th>
+            <th>Unsubscribe</th>
+            <th>Apache Archive</th>
+            <th>Other Archives</th>
+        </tr>
+        <tr class="a">
+            <td>
+            <b>Apache Announce List</b>
+            <br></br><br></br>
+            General announcements of Apache project releases. Low traffic.
+            </td>
+            <td>
+                <a class="externalLink" href="mailto:announce-subscribe@apache.org">Subscribe</a>
+            </td>
+            <td>
+                <a class="externalLink" href="mailto:announce-unsubscribe@apache.org">Unsubscribe</a>
+            </td>
+            <td>
+                <a class="externalLink" href="http://mail-archives.apache.org/mod_mbox/announce/">mail-archives.apache.org</a>
+            </td>
+            <td>
+                <a class="externalLink" href="http://markmail.org/list/org.apache.announce/">markmail.org</a>
+                <br></br>
+                <a class="externalLink" href="http://old.nabble.com/Apache-News-and-Announce-f109.html">old.nabble.com</a>
+                <br></br>
+                <a class="externalLink" href="http://www.mail-archive.com/announce@apache.org/">www.mail-archive.com</a>
+                <br></br>
+                <a class="externalLink" href="http://news.gmane.org/gmane.comp.apache.announce">news.gmane.org</a>
+            </td>
+        </tr>
+    </tbody>
+</table>
+  </section>
+</body>
+</document>

Propchange: commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml
------------------------------------------------------------------------------
    svn:eol-style = native



Re: svn commit: r931515 - /commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml

Posted by sebb <se...@gmail.com>.
On 07/04/2010, Niall Pemberton <ni...@gmail.com> wrote:
> On Wed, Apr 7, 2010 at 1:42 PM, sebb AT ASF <se...@apache.org> wrote:
>  > On 07/04/2010, sebb@apache.org <se...@apache.org> wrote:
>  >> Author: sebb
>  >>  Date: Wed Apr  7 12:17:25 2010
>  >>  New Revision: 931515
>  >>
>  >>  URL: http://svn.apache.org/viewvc?rev=931515&view=rev
>  >>  Log:
>  >>  Initial version of generic mailing list page.
>  >>  Not yet included in navigation links.
>  >>
>  >
>  > Generated and uploaded to:
>  >
>  > http://people.apache.org/~sebb/commons/mailing-lists.html
>
>
> It should IMO be renamed to mail-lists.xml - so that it replaces the
>  maven generated one - rather than adding a second mailing list page.

OK; I just picked the name because it was descriptive.

But I see that you have updated commons-build to autogenerate the page
anyway; not sure that the page is needed anymore?

>
>  Niall
>
>
>  ---------------------------------------------------------------------
>  To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>  For additional commands, e-mail: dev-help@commons.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: svn commit: r931515 - /commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml

Posted by Niall Pemberton <ni...@gmail.com>.
On Wed, Apr 7, 2010 at 1:42 PM, sebb AT ASF <se...@apache.org> wrote:
> On 07/04/2010, sebb@apache.org <se...@apache.org> wrote:
>> Author: sebb
>>  Date: Wed Apr  7 12:17:25 2010
>>  New Revision: 931515
>>
>>  URL: http://svn.apache.org/viewvc?rev=931515&view=rev
>>  Log:
>>  Initial version of generic mailing list page.
>>  Not yet included in navigation links.
>>
>
> Generated and uploaded to:
>
> http://people.apache.org/~sebb/commons/mailing-lists.html

It should IMO be renamed to mail-lists.xml - so that it replaces the
maven generated one - rather than adding a second mailing list page.

Niall

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: svn commit: r931515 - /commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml

Posted by Jörg Schaible <jo...@gmx.de>.
sebb wrote at Mittwoch, 7. April 2010 15:33:

> On 07/04/2010, Jörg Schaible <jo...@gmx.de> wrote:
>> Hi Sebb,
>>
>>  sebb AT ASF wrote at Mittwoch, 7. April 2010 14:42:
>>
>>
>>  > On 07/04/2010, sebb@apache.org <se...@apache.org> wrote:
>>  >> Author: sebb
>>  >>  Date: Wed Apr  7 12:17:25 2010
>>  >>  New Revision: 931515
>>  >>
>>  >>  URL: http://svn.apache.org/viewvc?rev=931515&view=rev
>>  >>  Log:
>>  >>  Initial version of generic mailing list page.
>>  >>  Not yet included in navigation links.
>>  >>
>>  >
>>  > Generated and uploaded to:
>>  >
>>  > http://people.apache.org/~sebb/commons/mailing-lists.html
>>
>>
>> Can you add that the "commits" and "jira" lists are read-only for humans
>> and
>>  fed by backend systems only?
> 
> I thought I had made this clear - what needs to be changed?

* "[jira] - this is automatically added by JIRA messages (issues list)" to 
"[jira] - this is automatically added by JIRA messages (issues list - read 
only)"

* "This list is only for e-mails generated by JIRA, the issue tracking 
system used by Apache Commons. High traffic." to "This list is read-only and 
used for e-mails generated by JIRA, the issue tracking system used by Apache 
Commons. High traffic."

* similar wording for Commits List as above

It's simply to make it very explicit. Occasionally we see people post to one 
of those lists. Personally I am not even able to give a corrective answer, 
since I am using normally Gmane as interface to the lists.

>>  Additionally it would be nice to emphasis that
>>  the user's list should be used for questions in first place.
> 
> What do you suggest?

* "There is only one developer list, and one user list" to "There is only 
one user list, and one developer list"

Add a phrase after the examples like:

"The user's list is normally the appropriate list for all kind of questions, 
even if you try to contact the developers of a component. They are 
subscribed also."

- Jörg


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: svn commit: r931515 - /commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml

Posted by sebb <se...@gmail.com>.
On 07/04/2010, Jörg Schaible <jo...@gmx.de> wrote:
> Hi Sebb,
>
>  sebb AT ASF wrote at Mittwoch, 7. April 2010 14:42:
>
>
>  > On 07/04/2010, sebb@apache.org <se...@apache.org> wrote:
>  >> Author: sebb
>  >>  Date: Wed Apr  7 12:17:25 2010
>  >>  New Revision: 931515
>  >>
>  >>  URL: http://svn.apache.org/viewvc?rev=931515&view=rev
>  >>  Log:
>  >>  Initial version of generic mailing list page.
>  >>  Not yet included in navigation links.
>  >>
>  >
>  > Generated and uploaded to:
>  >
>  > http://people.apache.org/~sebb/commons/mailing-lists.html
>
>
> Can you add that the "commits" and "jira" lists are read-only for humans and
>  fed by backend systems only?

I thought I had made this clear - what needs to be changed?

>  Additionally it would be nice to emphasis that
>  the user's list should be used for questions in first place.

What do you suggest?

>  Regards,
>  Jörg
>
>
>  ---------------------------------------------------------------------
>  To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>  For additional commands, e-mail: dev-help@commons.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: svn commit: r931515 - /commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml

Posted by Jörg Schaible <jo...@gmx.de>.
Hi Sebb,

sebb AT ASF wrote at Mittwoch, 7. April 2010 14:42:

> On 07/04/2010, sebb@apache.org <se...@apache.org> wrote:
>> Author: sebb
>>  Date: Wed Apr  7 12:17:25 2010
>>  New Revision: 931515
>>
>>  URL: http://svn.apache.org/viewvc?rev=931515&view=rev
>>  Log:
>>  Initial version of generic mailing list page.
>>  Not yet included in navigation links.
>>
> 
> Generated and uploaded to:
> 
> http://people.apache.org/~sebb/commons/mailing-lists.html

Can you add that the "commits" and "jira" lists are read-only for humans and 
fed by backend systems only? Additionally it would be nice to emphasis that 
the user's list should be used for questions in first place.

Regards,
Jörg


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: svn commit: r931515 - /commons/proper/commons-site/trunk/src/site/xdoc/mailing-lists.xml

Posted by sebb AT ASF <se...@apache.org>.
On 07/04/2010, sebb@apache.org <se...@apache.org> wrote:
> Author: sebb
>  Date: Wed Apr  7 12:17:25 2010
>  New Revision: 931515
>
>  URL: http://svn.apache.org/viewvc?rev=931515&view=rev
>  Log:
>  Initial version of generic mailing list page.
>  Not yet included in navigation links.
>

Generated and uploaded to:

http://people.apache.org/~sebb/commons/mailing-lists.html

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org