github.com/slspeek/camlistore_namedsearch@v0.0.0-20140519202248-ed6f70f7721a/website/content/code (about)

     1  <h1>Get the code</h1>
     2  
     3  <pre>$ git clone https://camlistore.googlesource.com/camlistore</pre>
     4  
     5  <ul>
     6    <li><a href="https://camlistore.googlesource.com/camlistore">Latest changes</a></li>
     7    <li><a href="https://camlistore.googlesource.com/camlistore/+/master">Browse tree</a></li>
     8    <li><a href="https://camlistore-review.googlesource.com/">Code Review</a></li>
     9  </ul>
    10  
    11  <h2>Making apps that work with Camlistore</h2>
    12  
    13  <p>Camlistore is built so that other apps can securely access and store data without running alongside it. Camlistore is the perfect backing store for other web apps and CMSes.</p>
    14  
    15  <p>Detailed documention on the HTTP blob retrieval protocol can be found at <a href="/docs/protocol">the protocol documentation</a>. The <a href="/pkg/client">client</a>, <a href="/pkg/search">search</a> and <a href="/pkg/schema">schema</a> packages are also a good place to start.</p>
    16  
    17  <h2 id="contributing">Contributing to Camlistore</h2>
    18  
    19  <ul class='lispaced'>
    20     <li>Join the <a href="https://groups.google.com/group/camlistore">mailing list</a>.</li>
    21     <li>Pick something that interests you, or look through our list of <a href="/docs/todo">potential projects</a> for inspiration. <strong>Discuss it first</strong>, especially if it's large and/or not well designed yet. You'll save yourself a headache if someone is already working on something similar or if there's a more Camlistore-like approach to the issue.</li>
    22     <li>Submit your changes through the review process discussed below.</li>
    23     <li>Note that you'll need to agree to the appropriate Contributor License Agreement:
    24         <ul>
    25            <li><a href="https://developers.google.com/open-source/cla/individual">Individual Contributor License Agreement</a> (electronic signature okay) </li>
    26            <li><a href="https://developers.google.com/open-source/cla/corporate">Corporate Contributor License Agreement</a> (requires faxing or mailing)</li>
    27         </ul>
    28         (These make lawyers feel all warm and cozy about open source)
    29     </li>
    30  </ul>
    31  
    32  <h3>Code Review</h3>
    33  <ul class='lispaced'>
    34  	<li>Camlistore requires changes to be reviewed before they are committed.</li>
    35          <li>Update your <tt>~/.netrc</tt> file with a Gerrit username and password.  Click the <strong>"Generate a new password"</strong> link from the top of <a href="https://camlistore.googlesource.com/">https://camlistore.googlesource.com/</a>.</li>
    36  	<li>Usual Work Flow</li>
    37  	<ul>
    38          <li>Create a topic branch, make some changes and commit away.</li>
    39          <li>Before review, squash your changes into a single change.</li>
    40          <li>Send for review. See <a href="https://camlistore.googlesource.com/camlistore/+/master/HACKING">HACKING</a> for how to install devcam, and then use:<pre>devcam review</pre></li>
    41          <li>Modify as necessary until change is merged. Amend your commit or squash to a single commit before sending for review again (be sure to keep the same <a href="http://gerrit.googlecode.com/svn/documentation/2.2.1/user-changeid.html">the Change-Id line</a>)</li>
    42  	</ul>
    43  </ul>