tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From t...@apache.org
Subject svn commit: r1002076 - in /tomcat/site/trunk: docs/getinvolved.html xdocs/getinvolved.xml
Date Tue, 28 Sep 2010 09:46:24 GMT
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-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


Mime
View raw message