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 se...@apache.org on 2008/02/21 21:52:45 UTC
svn commit: r629987 - in /jakarta/site: docs/site/mail.html
xdocs/site/mail.xml
Author: sebb
Date: Thu Feb 21 12:52:44 2008
New Revision: 629987
URL: http://svn.apache.org/viewvc?rev=629987&view=rev
Log:
Deprecate attachments and large inline chunks of code in e-mails
Modified:
jakarta/site/docs/site/mail.html
jakarta/site/xdocs/site/mail.xml
Modified: jakarta/site/docs/site/mail.html
URL: http://svn.apache.org/viewvc/jakarta/site/docs/site/mail.html?rev=629987&r1=629986&r2=629987&view=diff
==============================================================================
--- jakarta/site/docs/site/mail.html (original)
+++ jakarta/site/docs/site/mail.html Thu Feb 21 12:52:44 2008
@@ -230,7 +230,7 @@
<p>
<strong>
- Keep your email short and to the point.
+ Keep your email short and to the point; use a suitable subject line.
</strong>
<br/>
If your email is more than about a page of text, chances are that it
@@ -245,6 +245,15 @@
<p>
<strong>
+ Start a new thread for a new topic
+</strong>
+<br/>
+When asing a new question, please start a new thread with an appropriate new subject line.
+This makes it easier to read, and to find later in the archives.
+</p>
+
+<p>
+<strong>
Do your best to ensure that you are not sending HTML or
"Stylelized" email to the list.
</strong>
@@ -254,6 +263,18 @@
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>
+Please don't send attachments or include large chunks of code</strong>
+<br/>
+Attachments can be difficult to read and are rarely needed by all recipients.
+Some mailing lists are set up to drop them.
+If you need to send more than a few lines of code, ask first.
+Note that code is often mangled by word-wrapping, so it is better to provide a link to a downloadable file.
+If necessary, arrange with the person(s) responding to the posting how best to give access to the data,
+should it prove necessary.
</p>
<p>
Modified: jakarta/site/xdocs/site/mail.xml
URL: http://svn.apache.org/viewvc/jakarta/site/xdocs/site/mail.xml?rev=629987&r1=629986&r2=629987&view=diff
==============================================================================
--- jakarta/site/xdocs/site/mail.xml (original)
+++ jakarta/site/xdocs/site/mail.xml Thu Feb 21 12:52:44 2008
@@ -99,7 +99,7 @@
<p>
<strong>
- Keep your email short and to the point.
+ Keep your email short and to the point; use a suitable subject line.
</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
@@ -113,6 +113,14 @@
<p>
<strong>
+ Start a new thread for a new topic
+</strong><br/>
+When asing a new question, please start a new thread with an appropriate new subject line.
+This makes it easier to read, and to find later in the archives.
+</p>
+
+<p>
+<strong>
Do your best to ensure that you are not sending HTML or
"Stylelized" email to the list.
</strong><br/>
@@ -121,6 +129,17 @@
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>
+Please don't send attachments or include large chunks of code</strong><br/>
+Attachments can be difficult to read and are rarely needed by all recipients.
+Some mailing lists are set up to drop them.
+If you need to send more than a few lines of code, ask first.
+Note that code is often mangled by word-wrapping, so it is better to provide a link to a downloadable file.
+If necessary, arrange with the person(s) responding to the posting how best to give access to the data,
+should it prove necessary.
</p>
<p>
---------------------------------------------------------------------
To unsubscribe, e-mail: site-cvs-unsubscribe@jakarta.apache.org
For additional commands, e-mail: site-cvs-help@jakarta.apache.org