svn commit: r677850 - in /archiva/site/src/site/apt: developers/how-we-do-things.apt get-involved.apt

[oc...@apache.org]

Author: oching
Date: Fri Jul 18 00:49:21 2008
New Revision: 677850

URL: http://svn.apache.org/viewvc?rev=677850&view=rev
Log:
added 'how we do things' doc 

Added:
    archiva/site/src/site/apt/developers/how-we-do-things.apt
Modified:
    archiva/site/src/site/apt/get-involved.apt

Added: archiva/site/src/site/apt/developers/how-we-do-things.apt
URL: http://svn.apache.org/viewvc/archiva/site/src/site/apt/developers/how-we-do-things.apt?rev=677850&view=auto
==============================================================================
--- archiva/site/src/site/apt/developers/how-we-do-things.apt (added)
+++ archiva/site/src/site/apt/developers/how-we-do-things.apt Fri Jul 18 00:49:21 2008
@@ -0,0 +1,39 @@
+ -----
+ How We Do Things
+ -----
+
+How We Do Things
+
+ Below are the conventions we follow in Archiva.
+
+* Code Style
+
+  There isn't any code style that needs to be followed as long as it is consistent, can be checked in checkstyle, can be
+  formatted in Eclipse, IDEA and NetBeans. And the following rules must be followed:
+
+   [[1]] Use spaces, not tabs
+
+          * 4 spaces for Java
+
+          * 2 spaces for XML
+
+   [[2]] 120 column wrap, not 80
+
+   [[3]] Wrap on spaces, not on '.' in a method call
+
+* Versioning
+
+  It has been established in the community that the following style would be followed for the versioning of releases:
+
+-----
+Milestones -> Final -> Patch releases (e.g. 1.1-M1, 1.1-M2, 1.1, 1.1.1, 1.1.2 )
+-----
+
+  As much as possible, the team is aiming for frequent releases. If the roadmap for the current development version is
+  big, milestone releases can be applied until the final release. But if the roadmap is composed of just a small number
+  of issues, we could proceed immediately to preparing a release candidate and push it out as the final release once it
+  passes the vote.
+
+* References
+
+  * {{{http://www.nabble.com/Fwd%3A-What-do-we-need-to-establish--td17098487.html} Mailing list discussion regarding conventions}} 

Modified: archiva/site/src/site/apt/get-involved.apt
URL: http://svn.apache.org/viewvc/archiva/site/src/site/apt/get-involved.apt?rev=677850&r1=677849&r2=677850&view=diff
==============================================================================
--- archiva/site/src/site/apt/get-involved.apt (original)
+++ archiva/site/src/site/apt/get-involved.apt Fri Jul 18 00:49:21 2008
@@ -57,7 +57,8 @@
 
   * <<Fix bugs>>\
     Report bugs, feature requests and other issues in the
-    {{{issue-tracking.html}Jira}} issue tracking system.
+    {{{issue-tracking.html}Jira}} issue tracking system. Also, read up on 
+    {{{developers/how-we-do-things.html}how we do things}} in Archiva.
 
   * <<Build it>>\
 	 Build Archiva for yourself, in order to fix bugs. Submit patches to