Contributor guide

We welcome your contributions - Thanks for helping make Cedar a better project for everyone. Please review the backlog, issues list and discussion list before reporting issues or starting work. What you're looking for may already have been done. If it hasn't, the community can help make your contribution better.

Reporting issues

Please report problems to the issues list.

Updating documentation

This wiki belongs to the community. Please feel free to improve the documentation found here.

Making changes

In order to make changes, you need to get your development environment set up, make your changes on a fork of the Cedar repository and then issue a pull request. Please follow the advice below to ensure that your contribution will be readily accepted.

Development environment setup

• Please use the latest release (not beta) version of Xcode and ensure you have installed the command line tools and iOS simulator 5.1
• Fork the cedar repository at github
• Clone the forked repository locally
• Open a terminal and change directory to where you cloned the repo
• Run rake and make sure all tests pass

Make your changes

• Create a branch for your changes (optional, but highly encouraged)
• Write tests for your changes.
• Make your tests pass by implementing your changes
• Ensure all tests still pass when you run rake
• Push your changes up to your fork at github

Make a pull request

When you have finished making your changes and testing them, go to your forked repo on github and issue a pull request for the branch containing your changes. Please keep in mind the following before submitting your pull request:

• Please include tests. They help us understand your intent and prevent future changes from breaking your work. Changes without tests are usually ignored.
• Please ensure all tests pass (via rake) before making a pull request. Your contribution shouldn't break Cedar for other users.
• Please ensure all trailing whitespace characters are removed from your changes.