doc/mail.xml - struts1 - Git at Google

 <?xml version="1.0"?>
 <!--
 Copyright 1999-2004 The Apache Software Foundation
 Licensed 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>Mailing List Guidelines</title>
   </properties>

 <body>

 <section name="Mailing Lists - Guidelines">

 <p>A mailing list is an electronic discussion forum that anyone can
 subscribe to. When someone sends an email message to the mailing list,
 a copy of that message is broadcast to everyone who is subscribed to
 that mailing list. Mailing lists provide a simple and effective
 communication mechanism. With potentially thousands of subscribers,
 there is a common set of etiquette guidelines that you should observe.
 Please keep on reading.
 </p>


 <p>
 <strong>
       Respect the mailing list type
 </strong>
 </p>

 <ul>
     <li>
     The "User" list is where you can send questions and comments about
     configuration, setup, usage and other "user" types of questions.
     </li>
     <li>
     The "Developer" (or "Dev") list is where you can send questions and
     comments about the actual software source code and general
     "development" types of questions.
     </li>
 </ul>

 <p>Some questions are appropriate for posting on both the "user" and
 the "developer" lists. In this case, pick one and only one. Do not
 cross post.</p>

 <p>Asking a configuration question on the developers list is frowned
 upon because developers' time is as precious as yours. By contacting
 them directly instead of the user base you are abusing resources. In
 fact, it is unlikely that you will get a quicker answer, if at
 all.</p>

 <p>
 <strong>
       Join the lists that are appropriate for your discussion.
 </strong><br />
 Please make sure that you are joining the list that is appropriate for the
 topic or product that you would like to discuss. For example,
 please do not join the Struts mailing list and ask questions about Tomcat.
 Instead, you should join the Tomcat User list and ask your questions
 there.
 </p>

 <p>
 <strong>
     Ask smart questions.
 </strong><br />
 Every volunteer project obtains its strength from the people involved
 in it. You are welcome to join any of our mailing lists.  You can
 choose to lurk, or actively participate; it's up to you.  The level of
 community responsiveness to specific questions is generally directly
 proportional to the amount of effort you spend formulating your
 question. Eric Raymond and Rick Moen have even written an essay entitled <a
 href="http://www.catb.org/~esr/faqs/smart-questions.html">"<b>Asking
 Smart Questions</b>"</a> precisely on this topic.
 </p>

 <p>
 <strong>
     Keep your email short and to the point.
 </strong><br />
 If your email is more than about a page of text, chances are that it
 won't get read by very many people. It is much better to try to pack a
 lot of informative information (see above about asking smart questions)
 into as small of an email as possible. If you are replying to a previous
 email, it is a good idea to only quote the parts that you are replying
 to and to remove the unnecessary bits. This makes it easier for people
 to follow a thread as well as making the email archives easier to search
 and read.
 </p>

 <p>
 <strong>
     Do your best to ensure that you are not sending HTML or
     "Stylelized" email to the list.
 </strong><br />
 If you are using Outlook or Outlook Express or Eudora, chances are that
 you are sending HTML email by default. There is usually a setting that
 will allow you to send "Plain Text" email. If you are using Microsoft
 products to send email, there are several bugs in the software that
 prevent you from turning off the sending of HTML email. Please read this
 <a href="./micromail.html">page</a> as well...
 </p>

 <p>
 <strong>
     Do not cross post messages.
 </strong><br />
 In other words, pick a mailing list and send your messages to that mailing
 list only. Do not send your messages to multiple mailing lists. The reason is
 that people may be subscribed to one list and not to the other. Therefore,
 some people will only see part of the conversation.
 </p>

 <p>
 <strong>Watch where you are sending email.</strong>.
 The majority of our mailing lists have set the Reply-To to go back to the
 list. That means that when you Reply to a message, it will go to the list
 and not to the original author directly. The reason is because it helps
 facilitate discussion on the list for everyone to benefit from. Be careful
 of this as sometimes you may intend to reply to a message directly to someone
 instead of the entire list.
 The appropriate contents of the Reply-To header is an age-old debate that
 should not be brought up on the mailing lists.  You can
 examine opposing points of view
 <a href="http://www.unicom.com/pw/reply-to-harmful.html">condemning</a> our convention and
 <a href="http://www.metasystema.org/essays/reply-to-useful.mhtml">condoning</a>
 it. Bringing this up for debate on a mailing list will add nothing
 new and is considered off-topic.
 </p>

 </section>

 <section name="Archives">
 <p>Archives Carrying Struts Lists</p>
 <ul>
 <li><a href="http://nagoya.apache.org/eyebrowse/SummarizeList?listId=41">List Index on nagoya.apache.org</a></li>
 <li><a href="http://www.mail-archive.com/user%40struts.apache.org/">Mail-Archive</a></li>
 <li><a href="http://marc.theaimsgroup.com/?l=struts-user&amp;r=1&amp;w=2">MARC: Mailing list ARChives</a></li>
 <li><a href="http://www.servlets.com/archive/servlet/SummarizeList?listName=struts-user">Servlets.com servlet and JSP list archives</a></li>
 </ul>
 </section>

 <section name="Subscribing">
 <p>
 Now that you've read the guidelines (you <em>have</em> read the rest of the page, haven't you?), please subscribe to
 whichever Struts lists are of interest.
 </p>

     <ul>

     <li>
       <strong>STRUTS-ANNOUNCE Mailing List</strong> - Subscribe to this list
       to receiving only major announcements regarding Struts. This is a low-volume,
       read-only list.<br />
       [<a href="mailto:announce-subscribe@struts.apache.org">Subscribe</a>]<br />
       [<a href="mailto:announce-unsubscribe@struts.apache.org">Unsubscribe</a>]
     </li>

     <li>
       <strong>STRUTS-USER Mailing List</strong> - Subscribe to this list
       to communicate with other developers that are using
       Struts for their own applications, including questions about the
       installation of Struts, and the usage of particular Struts features.<br />
       [<a href="mailto:user-subscribe@struts.apache.org">Subscribe</a>]<br />
       [<a href="mailto:user-unsubscribe@struts.apache.org">Unsubscribe</a>]
     </li>

     <li>
       <strong>STRUTS-DEV Mailing List</strong> - Subscribe to this mailing
       list to communicate with other developers interested in expanding and
       improving the functionality supported by Struts itself.<br />
       [<a href="mailto:dev-subscribe@struts.apache.org">Subscribe</a>]<br />
       [<a href="mailto:dev-unsubscribe@struts.apache.org">Unsubscribe</a>]
     </li>

     <li>
       <strong>STRUTS-USER Digest</strong> - Subscribe to this list to receive
       a daily digest of the Struts USER list.<br />
       [<a href="mailto:user-digest-subscribe@struts.apache.org">Subscribe</a>]<br />
       [<a href="mailto:user-digest-unsubscribe@struts.apache.org">Unsubscribe</a>]<br />
       If you subscribe to the Digest, you can also post to the User list.
       (Just don't quote the entire Digest mailing in a reply!)
     </li>

     <li>
       <strong>STRUTS-USER Newsgroup</strong> - The User list is also mirrored online,
       so that you can participate <strong>without</strong> subscribing to the regular mailing
       list.<br />
       [<a href="http://www.proj.com/subscribe.jsp">Struts Newsgroup</a>]<br />
       This is another way to post to the User list without subscribing to the
       regular list. <br/>
       </li>
     </ul>
 </section>
 <section>
     <p class="right">
         <strong>Back to:</strong> <a href="using.html">Using Struts</a>
     </p>
 </section>
 </body>
 </document>
	<?xml version="1.0"?>
	<!--
	Copyright 1999-2004 The Apache Software Foundation
	Licensed 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>Mailing List Guidelines</title>
	</properties>

	<body>

	<section name="Mailing Lists - Guidelines">

	<p>A mailing list is an electronic discussion forum that anyone can
	subscribe to. When someone sends an email message to the mailing list,
	a copy of that message is broadcast to everyone who is subscribed to
	that mailing list. Mailing lists provide a simple and effective
	communication mechanism. With potentially thousands of subscribers,
	there is a common set of etiquette guidelines that you should observe.
	Please keep on reading.
	</p>


	<p>
	<strong>
	Respect the mailing list type
	</strong>
	</p>

	<ul>
	<li>
	The "User" list is where you can send questions and comments about
	configuration, setup, usage and other "user" types of questions.
	</li>
	<li>
	The "Developer" (or "Dev") list is where you can send questions and
	comments about the actual software source code and general
	"development" types of questions.
	</li>
	</ul>

	<p>Some questions are appropriate for posting on both the "user" and
	the "developer" lists. In this case, pick one and only one. Do not
	cross post.</p>

	<p>Asking a configuration question on the developers list is frowned
	upon because developers' time is as precious as yours. By contacting
	them directly instead of the user base you are abusing resources. In
	fact, it is unlikely that you will get a quicker answer, if at
	all.</p>

	<p>
	<strong>
	Join the lists that are appropriate for your discussion.
	</strong><br />
	Please make sure that you are joining the list that is appropriate for the
	topic or product that you would like to discuss. For example,
	please do not join the Struts mailing list and ask questions about Tomcat.
	Instead, you should join the Tomcat User list and ask your questions
	there.
	</p>

	<p>
	<strong>
	Ask smart questions.
	</strong><br />
	Every volunteer project obtains its strength from the people involved
	in it. You are welcome to join any of our mailing lists. You can
	choose to lurk, or actively participate; it's up to you. The level of
	community responsiveness to specific questions is generally directly
	proportional to the amount of effort you spend formulating your
	question. Eric Raymond and Rick Moen have even written an essay entitled <a
	href="http://www.catb.org/~esr/faqs/smart-questions.html">"<b>Asking
	Smart Questions</b>"</a> precisely on this topic.
	</p>

	<p>
	<strong>
	Keep your email short and to the point.
	</strong><br />
	If your email is more than about a page of text, chances are that it
	won't get read by very many people. It is much better to try to pack a
	lot of informative information (see above about asking smart questions)
	into as small of an email as possible. If you are replying to a previous
	email, it is a good idea to only quote the parts that you are replying
	to and to remove the unnecessary bits. This makes it easier for people
	to follow a thread as well as making the email archives easier to search
	and read.
	</p>

	<p>
	<strong>
	Do your best to ensure that you are not sending HTML or
	"Stylelized" email to the list.
	</strong><br />
	If you are using Outlook or Outlook Express or Eudora, chances are that
	you are sending HTML email by default. There is usually a setting that
	will allow you to send "Plain Text" email. If you are using Microsoft
	products to send email, there are several bugs in the software that
	prevent you from turning off the sending of HTML email. Please read this
	<a href="./micromail.html">page</a> as well...
	</p>

	<p>
	<strong>
	Do not cross post messages.
	</strong><br />
	In other words, pick a mailing list and send your messages to that mailing
	list only. Do not send your messages to multiple mailing lists. The reason is
	that people may be subscribed to one list and not to the other. Therefore,
	some people will only see part of the conversation.
	</p>

	<p>
	<strong>Watch where you are sending email.</strong>.
	The majority of our mailing lists have set the Reply-To to go back to the
	list. That means that when you Reply to a message, it will go to the list
	and not to the original author directly. The reason is because it helps
	facilitate discussion on the list for everyone to benefit from. Be careful
	of this as sometimes you may intend to reply to a message directly to someone
	instead of the entire list.
	The appropriate contents of the Reply-To header is an age-old debate that
	should not be brought up on the mailing lists. You can
	examine opposing points of view
	<a href="http://www.unicom.com/pw/reply-to-harmful.html">condemning</a> our convention and
	<a href="http://www.metasystema.org/essays/reply-to-useful.mhtml">condoning</a>
	it. Bringing this up for debate on a mailing list will add nothing
	new and is considered off-topic.
	</p>

	</section>

	<section name="Archives">
	<p>Archives Carrying Struts Lists</p>
	<ul>
	<li><a href="http://nagoya.apache.org/eyebrowse/SummarizeList?listId=41">List Index on nagoya.apache.org</a></li>
	<li><a href="http://www.mail-archive.com/user%40struts.apache.org/">Mail-Archive</a></li>
	<li><a href="http://marc.theaimsgroup.com/?l=struts-user&r=1&w=2">MARC: Mailing list ARChives</a></li>
	<li><a href="http://www.servlets.com/archive/servlet/SummarizeList?listName=struts-user">Servlets.com servlet and JSP list archives</a></li>
	</ul>
	</section>

	<section name="Subscribing">
	<p>
	Now that you've read the guidelines (you <em>have</em> read the rest of the page, haven't you?), please subscribe to
	whichever Struts lists are of interest.
	</p>

	<ul>

	<li>
	<strong>STRUTS-ANNOUNCE Mailing List</strong> - Subscribe to this list
	to receiving only major announcements regarding Struts. This is a low-volume,
	read-only list.<br />
	[<a href="mailto:announce-subscribe@struts.apache.org">Subscribe</a>]<br />
	[<a href="mailto:announce-unsubscribe@struts.apache.org">Unsubscribe</a>]
	</li>

	<li>
	<strong>STRUTS-USER Mailing List</strong> - Subscribe to this list
	to communicate with other developers that are using
	Struts for their own applications, including questions about the
	installation of Struts, and the usage of particular Struts features.<br />
	[<a href="mailto:user-subscribe@struts.apache.org">Subscribe</a>]<br />
	[<a href="mailto:user-unsubscribe@struts.apache.org">Unsubscribe</a>]
	</li>

	<li>
	<strong>STRUTS-DEV Mailing List</strong> - Subscribe to this mailing
	list to communicate with other developers interested in expanding and
	improving the functionality supported by Struts itself.<br />
	[<a href="mailto:dev-subscribe@struts.apache.org">Subscribe</a>]<br />
	[<a href="mailto:dev-unsubscribe@struts.apache.org">Unsubscribe</a>]
	</li>

	<li>
	<strong>STRUTS-USER Digest</strong> - Subscribe to this list to receive
	a daily digest of the Struts USER list.<br />
	[<a href="mailto:user-digest-subscribe@struts.apache.org">Subscribe</a>]<br />
	[<a href="mailto:user-digest-unsubscribe@struts.apache.org">Unsubscribe</a>]<br />
	If you subscribe to the Digest, you can also post to the User list.
	(Just don't quote the entire Digest mailing in a reply!)
	</li>

	<li>
	<strong>STRUTS-USER Newsgroup</strong> - The User list is also mirrored online,
	so that you can participate <strong>without</strong> subscribing to the regular mailing
	list.<br />
	[<a href="http://www.proj.com/subscribe.jsp">Struts Newsgroup</a>]<br />
	This is another way to post to the User list without subscribing to the
	regular list. <br/>
	</li>
	</ul>
	</section>
	<section>
	<p class="right">
	<strong>Back to:</strong> <a href="using.html">Using Struts</a>
	</p>
	</section>
	</body>
	</document>