github.com/olivere/camlistore@v0.0.0-20140121221811-1b7ac2da0199/website/content/docs/contributing (about)

     1  <h1>Contributing</h1>
     2  
     3  <p>Want to contribute to the project?  Awesome!</p>
     4  
     5  <ul class='lispaced'>
     6     <li>Join the <a href="/lists">mailing list</a>.  Say hi.</li>
     7     <li>Pick an area to tackle.  Discuss it first, especially if it's large and/or not well designed yet.</li>
     8     <li>See the <a href="https://camlistore.googlesource.com/camlistore/+/master/HACKING">HACKING</a> file at the root of the source to get started.</li>
     9     <li>Put your changes online somewhere for review &amp; git pulling.</li>
    10     <li>Note that you'll need to agree to the appropriate Contributor License Agreement:
    11         <ul>
    12            <li><a href="http://code.google.com/legal/individual-cla-v1.0.html">Individual Contributor License Agreement</a> (electronic signature okay) </li>
    13            <li><a href="http://code.google.com/legal/corporate-cla-v1.0.html">Corporate Contributor License Agreement</a> (requires faxing or mailing)</li>
    14         </ul>
    15         (These make lawyers feel all warm and cozy about open source.)
    16     </li>
    17  
    18     <li>We'll submit your changes initially; but once you contribute
    19     good changes for awhile, we'll get you direct commit access.</li>
    20  
    21  </ul>
    22  
    23  <h1>Code Review</h1>
    24  <ul class='lispaced'>
    25  	<li>Camlistore requires changes to be reviewed before they are committed.</li>
    26          <li>Update your <tt>~/.netrc</tt> file with a Gerrit username and password.  Click the <b>"Generate a new password"</b> link from the top of <a href="https://camlistore.googlesource.com/">https://camlistore.googlesource.com/</a>.</li>
    27  
    28  	<li>Usual Work Flow</li>
    29  		<ul>
    30                          <li>Create a topic branch. Commit away. If you modify or squash your commits during review, don't touch <a href="http://gerrit.googlecode.com/svn/documentation/2.2.1/user-changeid.html">the Change-Id line</a>.</li>
    31                          <li>Send for review, with:<pre>./misc/review</pre></li>
    32  			<li>... (review, modify, git add [changed files], git commit --amend, running ./misc/review again during review, until change is merged) ... </li>
    33  			<li>Finally, if you have any questions don't hesitate to ask the <a href='/lists'>mailing list</a> if you have questions.</li>
    34  		</ul>
    35  	<li>Have Fun!</li>
    36  </ul>