Apache Tomcat - Get Involved

Return-Path: Delivered-To: apmail-tomcat-dev-archive@www.apache.org Received: (qmail 70943 invoked from network); 28 Sep 2010 09:46:50 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 28 Sep 2010 09:46:50 -0000 Received: (qmail 51616 invoked by uid 500); 28 Sep 2010 09:46:50 -0000 Delivered-To: apmail-tomcat-dev-archive@tomcat.apache.org Received: (qmail 51163 invoked by uid 500); 28 Sep 2010 09:46:47 -0000 Mailing-List: contact dev-help@tomcat.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "Tomcat Developers List" Delivered-To: mailing list dev@tomcat.apache.org Received: (qmail 51154 invoked by uid 99); 28 Sep 2010 09:46:46 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 28 Sep 2010 09:46:46 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 28 Sep 2010 09:46:45 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 033022388A41; Tue, 28 Sep 2010 09:46:25 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: svn commit: r1002076 - in /tomcat/site/trunk: docs/getinvolved.html xdocs/getinvolved.xml Date: Tue, 28 Sep 2010 09:46:24 -0000 To: dev@tomcat.apache.org From: timw@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20100928094625.033022388A41@eris.apache.org> 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 @@ Apache Tomcat - Get Involved - - + + - - + +

-

@@ -24,28 +24,28 @@

-

- +

- -

-

+

+

Apache Tomcat

@@ -177,11 +177,11 @@

- +

+ + +

- + @@ -225,7 +225,88 @@ You should also read

-
+
+

+ + + + + + + + + + +

+ + + + + +Contributing Changes + + +

+

+

+ +
+If you want to start contributing changes, then the first step is to checkout the source +code and build Apache Tomcat. See the Building page in the documentation area for the +version of Apache Tomcat you want to work with for detailed instructions. +
+ +
+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. +
+ +
+Once you've got Apache Tomcat up and running, then the Apache +Contributors Tech Guide is a good place +to learn how to create and submit patches. +
+ +

+

+

+
+

+ + + + + + + + +

+ + + + + +Coding Conventions + + +

+

+

+Apache Tomcat has very loosely defined coding conventions, but the following guidelines will be useful: +
+
Use spaces for indenting, not tabs
+
80 char line width
+
Java source: { at end of line, 4 space indents
+
XML source: 2 space indents
+
+

+

+

+

@@ -234,17 +315,17 @@ You should also read

-

+

- + Copyright © 1999-2010, The Apache Software Foundation -
+
"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 +
+ +
+If you want to start contributing changes, then the first step is to checkout the source +code and build Apache Tomcat. See the Building page in the documentation area for the +version of Apache Tomcat you want to work with for detailed instructions. +
+ +
+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. +
+ +
+Once you've got Apache Tomcat up and running, then the Apache +Contributors Tech Guide is a good place +to learn how to create and submit patches. +
+ +
+ +
+Apache Tomcat has very loosely defined coding conventions, but the following guidelines will be useful: +
+
Use spaces for indenting, not tabs
+
80 char line width
+
Java source: { at end of line, 4 space indents
+
XML source: 2 space indents
+
+
+ --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org For additional commands, e-mail: dev-help@tomcat.apache.org