Author: timw
Date: Tue Sep 28 09:46:24 2010
New Revision: 1002076
URL: http://svn.apache.org/viewvc?rev=1002076&view=rev
Log:
Adding some content to the getting involved overview to give new contributors
some guidance.
Modified:
tomcat/site/trunk/docs/getinvolved.html
tomcat/site/trunk/xdocs/getinvolved.xml
Modified: tomcat/site/trunk/docs/getinvolved.html
URL:
http://svn.apache.org/viewvc/tomcat/site/trunk/docs/getinvolved.html?rev=1002076&r1=1002075&r2=1002076&view=diff
==============================================================================
--- tomcat/site/trunk/docs/getinvolved.html (original)
+++ tomcat/site/trunk/docs/getinvolved.html Tue Sep 28 09:46:24 2010
@@ -3,17 +3,17 @@
<html>
<head>
<title>Apache Tomcat - Get Involved</title>
-<link rel="stylesheet" href="stylesheets/tomcat.css" type="text/css" />
-<link media="print" rel="stylesheet" href="stylesheets/tomcat-printer.css"
type="text/css" />
+<link type="text/css" href="stylesheets/tomcat.css" rel="stylesheet"/>
+<link type="text/css" href="stylesheets/tomcat-printer.css" rel="stylesheet"
media="print"/>
</head>
-<body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000"
bgcolor="#ffffff">
-<table cellspacing="0" width="100%" border="0">
+<body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76"
vlink="#525D76">
+<table border="0" width="100%" cellspacing="0">
<!--PAGE HEADER-->
<tr>
<td>
<!--PROJECT LOGO-->
<a href="http://tomcat.apache.org/";>
-<img border="0" alt="Tomcat Logo" align="left" src="./images/tomcat.gif" />
+<img src="./images/tomcat.gif" align="left" alt="Tomcat Logo" border="0"/>
</a>
</td>
<td>
@@ -24,28 +24,28 @@
<td>
<!--APACHE LOGO-->
<a href="http://www.apache.org/";>
-<img border="0" alt="Apache Logo" align="right"
src="http://www.apache.org/images/asf-logo.gif"; />
+<img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt="Apache
Logo" border="0"/>
</a>
</td>
</tr>
</table>
<div class="searchbox noPrint">
-<form method="get" action="http://www.google.com/search";>
-<input type="hidden" name="sitesearch" value="tomcat.apache.org" />
-<input type="text" id="query" name="q" size="25" value="Search the Site" />
-<input type="submit" value="Search Site" name="Search" />
+<form action="http://www.google.com/search"; method="get">
+<input value="tomcat.apache.org" name="sitesearch" type="hidden"/>
+<input value="Search the Site" size="25" name="q" id="query" type="text"/>
+<input name="Search" value="Search Site" type="submit"/>
</form>
</div>
-<table cellspacing="4" width="100%" border="0">
+<table border="0" width="100%" cellspacing="4">
<!--HEADER SEPARATOR-->
<tr>
<td colspan="2">
-<hr size="1" noshade="" />
+<hr noshade="" size="1"/>
</td>
</tr>
<tr>
<!--LEFT SIDE NAVIGATION-->
-<td class="noPrint" nowrap="true" valign="top" width="20%">
+<td width="20%" valign="top" nowrap="true" class="noPrint">
<p>
<strong>Apache Tomcat</strong>
</p>
@@ -177,11 +177,11 @@
</ul>
</td>
<!--RIGHT SIDE MAIN BODY-->
-<td id="mainBody" align="left" valign="top" width="80%">
-<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<td width="80%" valign="top" align="left" id="mainBody">
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr>
<td bgcolor="#525D76">
-<font face="arial,helvetica,sanserif" color="#ffffff">
+<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Get Involved">
<!--()-->
</a>
@@ -225,7 +225,88 @@ You should also read
</tr>
<tr>
<td>
-<br />
+<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="Contributing Changes">
+<!--()-->
+</a>
+<a name="Contributing_Changes">
+<strong>Contributing Changes</strong>
+</a>
+</font>
+</td>
+</tr>
+<tr>
+<td>
+<p>
+<blockquote>
+
+<p>
+If you want to start contributing changes, then the first step is to checkout
the source
+code and build Apache Tomcat. See the <em>Building</em> page in the
documentation area for the
+version of Apache Tomcat you want to work with for detailed instructions.
+</p>
+
+<p>
+When making a contribution, minimize unnecessary or unrelated changes (such as
formatting).
+Apache Tomcat has many contributors, and being able to diff changes throughout
the source history is important.
+Making small gradual changes and respecting the conventions of the existing
source code
+will make it much more likely that your patch will be accepted.
+</p>
+
+<p>
+Once you've got Apache Tomcat up and running, then the Apache
+<a href="http://www.apache.org/dev/contributors.html";>Contributors Tech
Guide</a> is a good place
+to learn how to create and submit patches.
+</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="Coding Conventions">
+<!--()-->
+</a>
+<a name="Coding_Conventions">
+<strong>Coding Conventions</strong>
+</a>
+</font>
+</td>
+</tr>
+<tr>
+<td>
+<p>
+<blockquote>
+Apache Tomcat has very loosely defined coding conventions, but the following
guidelines will be useful:
+<ul>
+ <li>Use spaces for indenting, not tabs</li>
+ <li>80 char line width</li>
+ <li>Java source: { at end of line, 4 space indents</li>
+ <li>XML source: 2 space indents</li>
+</ul>
+</blockquote>
+</p>
+</td>
+</tr>
+<tr>
+<td>
+<br/>
</td>
</tr>
</table>
@@ -234,17 +315,17 @@ You should also read
<!--FOOTER SEPARATOR-->
<tr>
<td colspan="2">
-<hr size="1" noshade="" />
+<hr noshade="" size="1"/>
</td>
</tr>
<!--PAGE FOOTER-->
<tr>
<td colspan="2">
<div align="center">
-<font size="-1" color="#525D76">
+<font color="#525D76" size="-1">
<em>
Copyright © 1999-2010, The Apache Software Foundation
- <br />
+ <br/>
"Apache", the Apache feather, and the Apache Tomcat logo are
trademarks of the Apache Software Foundation for our open source
software.
Modified: tomcat/site/trunk/xdocs/getinvolved.xml
URL:
http://svn.apache.org/viewvc/tomcat/site/trunk/xdocs/getinvolved.xml?rev=1002076&r1=1002075&r2=1002076&view=diff
==============================================================================
--- tomcat/site/trunk/xdocs/getinvolved.xml (original)
+++ tomcat/site/trunk/xdocs/getinvolved.xml Tue Sep 28 09:46:24 2010
@@ -33,5 +33,38 @@ You should also read
</section>
+<section name="Contributing Changes">
+
+<p>
+If you want to start contributing changes, then the first step is to checkout
the source
+code and build Apache Tomcat. See the <em>Building</em> page in the
documentation area for the
+version of Apache Tomcat you want to work with for detailed instructions.
+</p>
+
+<p>
+When making a contribution, minimize unnecessary or unrelated changes (such as
formatting).
+Apache Tomcat has many contributors, and being able to diff changes throughout
the source history is important.
+Making small gradual changes and respecting the conventions of the existing
source code
+will make it much more likely that your patch will be accepted.
+</p>
+
+<p>
+Once you've got Apache Tomcat up and running, then the Apache
+<a href="http://www.apache.org/dev/contributors.html";>Contributors Tech
Guide</a> is a good place
+to learn how to create and submit patches.
+</p>
+
+</section>
+
+<section name="Coding Conventions">
+Apache Tomcat has very loosely defined coding conventions, but the following
guidelines will be useful:
+<ul>
+ <li>Use spaces for indenting, not tabs</li>
+ <li>80 char line width</li>
+ <li>Java source: { at end of line, 4 space indents</li>
+ <li>XML source: 2 space indents</li>
+</ul>
+</section>
+
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
![http://www.apache.org/images/asf-logo.gif"](http://www.apache.org/images/asf-logo.gif"){kind=link}