You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-cvs@jakarta.apache.org by ce...@apache.org on 2002/01/09 19:04:44 UTC
cvs commit: jakarta-site2/docs/site mail.html
ceki 02/01/09 10:04:44
Modified: xdocs/site mail.xml
docs/site mail.html
Log:
The patch contains a few corrections, a slight re-organisation and
some stylistic changes. I think it provides for easier reading.
Revision Changes Path
1.21 +43 -53 jakarta-site2/xdocs/site/mail.xml
Index: mail.xml
===================================================================
RCS file: /home/cvs/jakarta-site2/xdocs/site/mail.xml,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- mail.xml 8 Dec 2001 00:11:17 -0000 1.20
+++ mail.xml 9 Jan 2002 18:04:44 -0000 1.21
@@ -10,54 +10,50 @@
<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,
+<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. Because it is a forum with potentially
-thousands of subscribers, there is a common set of etiquette guidelines
-that should be observed (keep reading).
+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>
-Every volunteer project obtains its strength from the people involved
-in it. These people are joined through the mailing lists that they are
-subscribed to. You are welcome to join any of our mailing lists (or
-all of them if you wish). You can choose to lurk, or actively
-participate; it's up to you. The level of community responsiveness to
-specific questions you post about is generally directly proportional
-to the amount of effort you spend formulating your question.
-</p>
<p>
-<strong>Before you join any mailing lists, you should make sure that you
-read and follow the information below...</strong>
-</p>
-
-<p>
-We ask that you do your best to respect the charter of the appropriate
-mailing list. There are generally two types of lists that you can join.
+<strong>
+ Respect the mailing list type
+</strong><br/>
+ There are generally two types of lists.
</p>
<p>
<ul>
<li>
- The "User" list is where you should send questions and comments
- about configuration, setup, usage and other "user" types of
- questions.
+ The "User" lists where you can send questions and comments about
+ configuration, setup, usage and other "user" types of questions.
</li>
<li>
- The "Developer" list is where you should should send questions and
+ 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>
- Summary: Join the lists that are appropriate for your discussion.
+ 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,
@@ -68,27 +64,22 @@
<p>
<strong>
- Summary: Do not abuse resources in order to get help.
-</strong><br/>
-Asking your configuration or user type of question on the developers list
-because you think that you will get help more quickly by going directly to
-the developers instead of to the user base is not very nice. Chances are
-that doing this will actually prevent people from answering your question
-because it is clear that you are trying to abuse resources.
-</p>
+ Ask smart questions. </strong><br/>
-<p>
-<strong>
- Summary: Ask smart questions.
-</strong><br/>
-<a href="http://www.tuxedo.org/~esr/faqs/smart-questions.html">Please
-read this essay</a> which details how to write a smart question.
-This will almost guarantee that you will get a good answer.
+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 has even written an essay entitled <a
+href="http://www.tuxedo.org/~esr/faqs/smart-questions.html">"Asking
+Smart Questions"</a> precisely on this topic. Although somewhat
+militant, it is definitely worth reading.
</p>
<p>
<strong>
- Summary: Keep your email short and to the point.
+ 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
@@ -102,7 +93,7 @@
<p>
<strong>
- Summary: Do your best to ensure that you are not sending HTML or
+ 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
@@ -115,7 +106,7 @@
<p>
<strong>
- Summary: Watch where you are sending email.
+ 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
@@ -138,22 +129,21 @@
<p>
<strong>
- Summary: Do not cross post messages.
+ 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 may only see half of the conversation.
+some people will only see part of the conversation.
</p>
<p>
<strong>Now that you have read the guidelines above</strong>, <a
-href="./mail2.html"><strong>here</strong></a> is the page that gives you
-a listing of the different mailing lists that you can join. If you
-managed to find this without reading the above information, chances are
-you will be sent back here to read it again before your question will
-get answered. So, you might as well take the time now to read it and
-save yourself from looking like a fool.
+href="./mail2.html"><strong>here</strong></a> is the page that gives
+you a listing of the different mailing lists that you can join. If you
+managed to find this without reading the above information, chances
+are you will be sent back here. You might as well read it now and save
+yourself the embarrassment.
</p>
</section>
1.47 +41 -52 jakarta-site2/docs/site/mail.html
Index: mail.html
===================================================================
RCS file: /home/cvs/jakarta-site2/docs/site/mail.html,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -r1.46 -r1.47
--- mail.html 8 Jan 2002 05:02:18 -0000 1.46
+++ mail.html 9 Jan 2002 18:04:44 -0000 1.47
@@ -141,49 +141,44 @@
</td></tr>
<tr><td>
<blockquote>
- <p>
-A mailing list is an electronic discussion forum that anyone can
-"subscribe" to. When someone sends an email message to the mailing list,
+ <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. Because it is a forum with potentially
-thousands of subscribers, there is a common set of etiquette guidelines
-that should be observed (keep reading).
+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>
-Every volunteer project obtains its strength from the people involved
-in it. These people are joined through the mailing lists that they are
-subscribed to. You are welcome to join any of our mailing lists (or
-all of them if you wish). You can choose to lurk, or actively
-participate; it's up to you. The level of community responsiveness to
-specific questions you post about is generally directly proportional
-to the amount of effort you spend formulating your question.
-</p>
- <p>
-<strong>Before you join any mailing lists, you should make sure that you
-read and follow the information below...</strong>
-</p>
- <p>
-We ask that you do your best to respect the charter of the appropriate
-mailing list. There are generally two types of lists that you can join.
+<strong>
+ Respect the mailing list type
+</strong><br />
+ There are generally two types of lists.
</p>
<p>
<ul>
<li>
- The "User" list is where you should send questions and comments
- about configuration, setup, usage and other "user" types of
- questions.
+ The "User" lists where you can send questions and comments about
+ configuration, setup, usage and other "user" types of questions.
</li>
<li>
- The "Developer" list is where you should should send questions and
+ 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>
- Summary: Join the lists that are appropriate for your discussion.
+ 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,
@@ -193,25 +188,20 @@
</p>
<p>
<strong>
- Summary: Do not abuse resources in order to get help.
-</strong><br />
-Asking your configuration or user type of question on the developers list
-because you think that you will get help more quickly by going directly to
-the developers instead of to the user base is not very nice. Chances are
-that doing this will actually prevent people from answering your question
-because it is clear that you are trying to abuse resources.
-</p>
- <p>
-<strong>
- Summary: Ask smart questions.
-</strong><br />
-<a href="http://www.tuxedo.org/~esr/faqs/smart-questions.html">Please
-read this essay</a> which details how to write a smart question.
-This will almost guarantee that you will get a good answer.
+ 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 has even written an essay entitled <a href="http://www.tuxedo.org/~esr/faqs/smart-questions.html">"Asking
+Smart Questions"</a> precisely on this topic. Although somewhat
+militant, it is definitely worth reading.
</p>
<p>
<strong>
- Summary: Keep your email short and to the point.
+ 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
@@ -224,7 +214,7 @@
</p>
<p>
<strong>
- Summary: Do your best to ensure that you are not sending HTML or
+ 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
@@ -236,7 +226,7 @@
</p>
<p>
<strong>
- Summary: Watch where you are sending email.
+ 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
@@ -258,20 +248,19 @@
</p>
<p>
<strong>
- Summary: Do not cross post messages.
+ 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 may only see half of the conversation.
+some people will only see part of the conversation.
</p>
<p>
-<strong>Now that you have read the guidelines above</strong>, <a href="./mail2.html"><strong>here</strong></a> is the page that gives you
-a listing of the different mailing lists that you can join. If you
-managed to find this without reading the above information, chances are
-you will be sent back here to read it again before your question will
-get answered. So, you might as well take the time now to read it and
-save yourself from looking like a fool.
+<strong>Now that you have read the guidelines above</strong>, <a href="./mail2.html"><strong>here</strong></a> is the page that gives
+you a listing of the different mailing lists that you can join. If you
+managed to find this without reading the above information, chances
+are you will be sent back here. You might as well read it now and save
+yourself the embarrassment.
</p>
</blockquote>
</p>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>