rdonkin 2003/12/01 13:31:49
Modified: docs/site newbie.html roles.html
xdocs/site newbie.xml
Log:
Added more information about ASF email accounts and also a short section on web site
maintenance.
Revision Changes Path
1.42 +99 -1 jakarta-site2/docs/site/newbie.html
Index: newbie.html
===================================================================
RCS file: /home/cvs/jakarta-site2/docs/site/newbie.html,v
retrieving revision 1.41
retrieving revision 1.42
diff -u -r1.41 -r1.42
--- newbie.html 20 Nov 2003 21:40:42 -0000 1.41
+++ newbie.html 1 Dec 2003 21:31:49 -0000 1.42
@@ -240,6 +240,9 @@
<li>
<a href="#Where can I learn more about working at Apache and Jakarta?">Where
can I learn more about working at Apache and Jakarta?</a>
</li>
+ <li>
+ <a href="#How can I get involved with maintaining the Jakarta Site?">How can I
get involved with maintaining the Jakarta Site?</a>
+ </li>
</ul>
</blockquote>
</p>
@@ -255,7 +258,74 @@
<tr><td>
<blockquote>
<p>
- You can use SSH and Pine or put a .forward file in your user directory [:FIXME:
Need a brief howto here] to send the mail to another account.
+ You can:
+ </p>
+ <ul>
+ <li>Connect using SSH and use Pine;</li>
+ <li>or put a <code>.forward</code> file in your home (user) directory
+ to send the mail to another account.
+ The <code>.forward</code> file should contain the name of the account you wish
the mail to be forwarded to.
+ </li>
+ </ul>
+ <p>
+ For example:
+ </p>
+ <div align="left">
+ <table cellspacing="4" cellpadding="0" border="0">
+ <tr>
+ <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ </tr>
+ <tr>
+ <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#ffffff"><pre>
[EMAIL PROTECTED]
+ </pre></td>
+ <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
+ </tr>
+ <tr>
+ <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ </tr>
+ </table>
+ </div>
+ <p>
+ Will forward all mail to <strong>[EMAIL PROTECTED]</strong>.
+ </p>
+ <p>
+ Reading email posted to your apache.org account is an important duty.
+ Official apache emails will be directed to this account.
+ It is considered best practice to use a <code>.forward</code> since
+ this channel will still be available for communication even if ssh has to be
locked
+ down (for example, in the event of an emergency).
+ (But many die-hard Apaches insist that pine rules...)
+ </p>
+ <p>
+ You will probably want to work out how to send mail whose <code>from</code>
header
+ is set to your apache.org address.
+ Note that the ASF does not run a mail transport agent so you'll need to post from
+ a standard email account with a fake <code>from</code>.
+ (How this can be done depends on the email client you have.)
+ </p>
+ <p>
+ There are certain mailing lists at apache which are only for committers.
+ You'll need to subscribe to these <code>from</code> your apache.org account.
+ Community at apache.org is a broad based forum for discussions about Apache
matters.
+ It's definitely worth subscribing but you may want to read a while (to
acclimatize ;)
+ before posting.
+ General at jakarta.apache.org is not committer-only but is also highly
recommended.
+ </p>
+ <p>
+ You may also consider creating now an openPGP compatible email signing
+ key for your apache.org account. At this time, it is not essential
+ but is recommended for many of the more important activities.
+ <a href="http://www.gnupg.org";>Gnu Privacy Guard</a> is a suitable open source
signer.
+ Please remember to upload your key to a public key server
+ (for example <a href="http://pgp.mit.edu/";>MIT</a>). Remember to bring it
+ to any face-to-face events where ASF folks may be present.
+ It's best practice to insist on identification before signing another's key.
</p>
</blockquote>
</p>
@@ -489,6 +559,34 @@
<a href="http://incubator.apache.org/";>some material</a>
is available.
</p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0"
cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="How can I get involved with maintaining the Jakarta
Site?"><strong>How can I get involved with maintaining the Jakarta Site?</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ Questions to do with the Jakarta site are handled on the general list at
jakarta.apache.org.
+ The current policy is that any jakarta committer may request (and receive)
karma for the site.
+ </p>
+ <p>
+ The mechanics are explained
+ <a href="http://jakarta.apache.org/site/jakarta-site2.html";>here</a> and
+ <a href="http://jakarta.apache.org/site/jakarta-site2b.html";>here</a>
+ It's usually best to post a <code>[PATCH]</code> or two to the list so that
other folks
+ can check them before.
+ </p>
+ <p>
+ Please treat this trust with respect. Remember to discuss any major changes
before committing them.
+ Remember to check carefully the results of any change carefully before
committing.
+ </p>
</blockquote>
</p>
</td></tr>
1.89 +2 -1 jakarta-site2/docs/site/roles.html
Index: roles.html
===================================================================
RCS file: /home/cvs/jakarta-site2/docs/site/roles.html,v
retrieving revision 1.88
retrieving revision 1.89
diff -u -r1.88 -r1.89
--- roles.html 1 Dec 2003 20:37:42 -0000 1.88
+++ roles.html 1 Dec 2003 21:31:49 -0000 1.89
@@ -241,7 +241,8 @@
The first stage of the process is that the result of the vote thread should be
carbon copied to the pmc list by the existing committer who will be executing
the required process. An email should be sent to the prospected committer offering
- them committership preferrable with the <code>from</code> header set to
anapache.org email address
+ them committership preferrable with the <code>from</code> header set to an
+ apache.org email address
and the <code>reply-to</code> header set to
<strong>pmc at jakarta.apache.org</strong> (so that the reply will be recorded on
that list).
Note that non-pmc members will need to add a additional <code>reply-to</code>
header so that they receive a copy.
1.8 +71 -2 jakarta-site2/xdocs/site/newbie.xml
Index: newbie.xml
===================================================================
RCS file: /home/cvs/jakarta-site2/xdocs/site/newbie.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- newbie.xml 8 Oct 2003 01:44:30 -0000 1.7
+++ newbie.xml 1 Dec 2003 21:31:49 -0000 1.8
@@ -47,6 +47,9 @@
<li>
<a href="#Where can I learn more about working at Apache and Jakarta?">Where
can I learn more about working at Apache and Jakarta?</a>
</li>
+ <li>
+ <a href="#How can I get involved with maintaining the Jakarta Site?">How can I
get involved with maintaining the Jakarta Site?</a>
+ </li>
</ul>
</section>
@@ -54,9 +57,57 @@
<section name="How do I setup my email account?" href="email">
<p>
- You can use SSH and Pine or put a .forward file in your user directory [:FIXME:
Need a brief howto here] to send the mail to another account.
+ You can:
+ </p>
+ <ul>
+ <li>Connect using SSH and use Pine;</li>
+ <li>or put a <code>.forward</code> file in your home (user) directory
+ to send the mail to another account.
+ The <code>.forward</code> file should contain the name of the account you wish
the mail to be forwarded to.
+ </li>
+ </ul>
+ <p>
+ For example:
+ </p>
+ <source>
[EMAIL PROTECTED]
+ </source>
+ <p>
+ Will forward all mail to <strong>[EMAIL PROTECTED]</strong>.
+ </p>
+ <p>
+ Reading email posted to your apache.org account is an important duty.
+ Official apache emails will be directed to this account.
+ It is considered best practice to use a <code>.forward</code> since
+ this channel will still be available for communication even if ssh has to be
locked
+ down (for example, in the event of an emergency).
+ (But many die-hard Apaches insist that pine rules...)
+ </p>
+ <p>
+ You will probably want to work out how to send mail whose <code>from</code>
header
+ is set to your apache.org address.
+ Note that the ASF does not run a mail transport agent so you'll need to post from
+ a standard email account with a fake <code>from</code>.
+ (How this can be done depends on the email client you have.)
+ </p>
+ <p>
+ There are certain mailing lists at apache which are only for committers.
+ You'll need to subscribe to these <code>from</code> your apache.org account.
+ Community at apache.org is a broad based forum for discussions about Apache
matters.
+ It's definitely worth subscribing but you may want to read a while (to
acclimatize ;)
+ before posting.
+ General at jakarta.apache.org is not committer-only but is also highly
recommended.
+ </p>
+ <p>
+ You may also consider creating now an openPGP compatible email signing
+ key for your apache.org account. At this time, it is not essential
+ but is recommended for many of the more important activities.
+ <a href='http://www.gnupg.org'>Gnu Privacy Guard</a> is a suitable open source
signer.
+ Please remember to upload your key to a public key server
+ (for example <a href='http://pgp.mit.edu/'>MIT</a>). Remember to bring it
+ to any face-to-face events where ASF folks may be present.
+ It's best practice to insist on identification before signing another's key.
</p>
-
</section>
<section name="How do I login to the CVS?" href="logon">
@@ -241,6 +292,24 @@
is available.
</p>
+ </section>
+
+ <section name="How can I get involved with maintaining the Jakarta Site?">
+ <p>
+ Questions to do with the Jakarta site are handled on the general list at
jakarta.apache.org.
+ The current policy is that any jakarta committer may request (and receive)
karma for the site.
+ </p>
+ <p>
+ The mechanics are explained
+ <a href="http://jakarta.apache.org/site/jakarta-site2.html";>here</a> and
+ <a href="http://jakarta.apache.org/site/jakarta-site2b.html";>here</a>
+ It's usually best to post a <code>[PATCH]</code> or two to the list so that
other folks
+ can check them before.
+ </p>
+ <p>
+ Please treat this trust with respect. Remember to discuss any major changes
before committing them.
+ Remember to check carefully the results of any change carefully before
committing.
+ </p>
</section>
</body>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
