Contributing

Want to contribute to the project? Awesome!

• Join the mailing list. Say hi.
• Pick an area to tackle. Discuss it first, especially if it's large and/or not well designed yet.
• See the HACKING file at the root of the source to get started.
• Put your changes online somewhere for review & git pulling.
• Note that you'll need to agree to the appropriate Contributor License Agreement:
  • Individual Contributor License Agreement (electronic signature okay)
  • Corporate Contributor License Agreement (requires faxing or mailing)
  (These make lawyers feel all warm and cozy about open source.)
• We'll submit your changes initially; but once you contribute good changes for awhile, we'll get you direct commit access.

Code Review

• Camlistore requires changes to be reviewed before they are committed.
• Update your ~/.netrc file with a Gerrit username and password. Click the "Generate a new password" link from the top of https://camlistore.googlesource.com/.
• Usual Work Flow
• Create a topic branch. Commit away. If you modify or squash your commits during review, don't touch the Change-Id line.
• Send for review, with:

  ./misc/review

• ... (review, modify, git add [changed files], git commit --amend, running ./misc/review again during review, until change is merged) ...
• Finally, if you have any questions don't hesitate to ask the mailing list if you have questions.
• Have Fun!