svn commit: r1296156 - /subversion/site/publish/contributing.html

[da...@apache.org]

Author: danielsh
Date: Fri Mar  2 11:43:22 2012
New Revision: 1296156

URL: http://svn.apache.org/viewvc?rev=1296156&view=rev
Log:
* contributing.html
  (#code-design): New section.  There is a missing link, which should be
    filled in.

Modified:
    subversion/site/publish/contributing.html

Modified: subversion/site/publish/contributing.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/contributing.html?rev=1296156&r1=1296155&r2=1296156&view=diff
==============================================================================
--- subversion/site/publish/contributing.html (original)
+++ subversion/site/publish/contributing.html Fri Mar  2 11:43:22 2012
@@ -179,6 +179,20 @@
        conventions</a>, and come join the fun!</p>
 </li>
 
+<li id="code-design"><p style="font-weight: bold;">Help design new features</p>
+    <p>Larger features do not just get written when someone has the time
+       and inclination to do so&mdash;they get designed first.  The process
+       involves discussions on the <a href="mailing-lists#dev-ml">dev@
+       list</a>, with reasonably detailed rationales and implementation plans
+       fly across the room.  (We often <a
+       href="http://wiki.apache.org/subversion/DesignNotes">use our wiki</a>
+       to work on the proposed designs.)  Participating in such a discussion
+       is an excellent way for users to ensure that planned new features are
+       designed from the very beginning to meet their use-cases and wishes, 
+       while for larger features holding such a discussion is key to establishing
+       <a href="">consensus</a> before any coding takes place.</p>
+</li>
+
 <li id="code-tests"><p style="font-weight: bold;">Convert a reproduction
     script into a regression test</p>
     <p>Often, users or developers post a <a href="#issues-recipe"