Menu
▾
▴
[Jboss-svn-commits] JBL Code SVN: r1093 - in trunk/labs/jbossweb/xdocs: . resources
|
From: <jbo...@li...> - 2005-09-13 10:54:22
|
Author: mla...@jb...
Date: 2005-09-13 06:54:14 -0400 (Tue, 13 Sep 2005)
New Revision: 1093
Added:
trunk/labs/jbossweb/xdocs/resources/mail.xml
Modified:
trunk/labs/jbossweb/xdocs/project.xml
trunk/labs/jbossweb/xdocs/resources/project.xml
Log:
Added mail.xml
Modified: trunk/labs/jbossweb/xdocs/project.xml
===================================================================
--- trunk/labs/jbossweb/xdocs/project.xml 2005-09-13 09:54:48 UTC (rev 1092)
+++ trunk/labs/jbossweb/xdocs/project.xml 2005-09-13 10:54:14 UTC (rev 1093)
@@ -14,6 +14,7 @@
<menu name="Resources">
<item name="FAQ" href="resources/faq.html"/>
<item name="Tutorial" href="resources/tut.html"/>
+ <item name="Mailing Lists" href="resources/mail.html"/>
</menu>
<menu name="News">
<item name="News & Status" href="news/2005.html"/>
Added: trunk/labs/jbossweb/xdocs/resources/mail.xml
===================================================================
--- trunk/labs/jbossweb/xdocs/resources/mail.xml 2005-09-13 09:54:48 UTC (rev 1092)
+++ trunk/labs/jbossweb/xdocs/resources/mail.xml 2005-09-13 10:54:14 UTC (rev 1093)
@@ -0,0 +1,174 @@
+<?xml version="1.0"?>
+<!DOCTYPE document [
+ <!ENTITY project SYSTEM "project.xml">
+]>
+<document url="mail.html">
+
+ &project;
+
+ <properties>
+ <author email="mla...@jb...">Mladen Turk</author>
+ <title>Mailing lists</title>
+ </properties>
+
+<body>
+
+<section name="Apache Tomcat">
+<br/>
+<subsection name="Tomcat User List">
+<p>
+This is the list where users of Tomcat meet and discuss issues. Developers are
+also expected to be lurking on this list to offer support to users of Tomcat.
+<ul>
+<li><a href="mailto:tom...@ja...">Subscribe</a></li>
+<li><a href="mailto:tom...@ja...">Unsubscribe</a></li>
+<li><a href="http://mail-archives.eu.apache.org/mod_mbox/jakarta-tomcat-user/">Archive</a></li>
+</ul>
+</p>
+</subsection>
+<subsection name="Tomcat Developer List">
+<p>
+This is the list where participating developers of the Tomcat Servlet Container
+meet and discuss issues, code changes/additions, etc. Subscribers to this list
+get notices of each and every code change, build results, testing notices, etc.
+Do not send mail to this list with usage questions or configuration problems --
+that's what tomcat-user is for.
+<ul>
+<li><a href="mailto:tom...@ja...">Subscribe</a></li>
+<li><a href="mailto:tom...@ja...">Unsubscribe</a></li>
+<li><a href="http://mail-archives.eu.apache.org/mod_mbox/jakarta-tomcat-dev/">Archive</a></li>
+</ul>
+</p>
+</subsection>
+</section>
+<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><br/>
+ There are generally two types of lists.
+</p>
+
+<p>
+<ul>
+ <li>
+ The "User" lists where you can send questions and comments about
+ configuration, setup, usage and other "user" types of questions.
+ </li>
+ <li>
+ The "Developer" lists where you can send questions and
+ comments about the actual software source code and general
+ "development" types of questions.
+ </li>
+</ul>
+</p>
+
+<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 Regexp 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. Although somewhat
+militant, it is definitely worth reading.<br/>
+<b>Note</b>: Please do NOT send your Java problems to the two authors. They welcome feedback on the FAQ's contents, but are simply not a Java help resource. Follow the essay's advice and <a href="http://www.catb.org/~esr/faqs/smart-questions.html#forum">choose your forum</a> carefully.
+</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.
+</p>
+
+<p>
+<strong>
+ Watch where you are sending email.
+</strong><br/>
+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.
+<em>
+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.
+</em>
+</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>
+</section>
+</body>
+</document>
Modified: trunk/labs/jbossweb/xdocs/resources/project.xml
===================================================================
--- trunk/labs/jbossweb/xdocs/resources/project.xml 2005-09-13 09:54:48 UTC (rev 1092)
+++ trunk/labs/jbossweb/xdocs/resources/project.xml 2005-09-13 10:54:14 UTC (rev 1093)
@@ -7,6 +7,7 @@
<menu name="Resources">
<item name="FAQ" href="faq.html"/>
<item name="Tutorial" href="tut.html"/>
+ <item name="Mailing Lists" href="mail.html"/>
</menu>
<menu name="FAQ">
<item name="General" href="faq01.html"/>
|
