Follow these steps to make a contribution to any of CF open source repositories:
-
Ensure that you have completed our CLA Agreement for individuals or corporations.
-
Set your name and email (these should match the information on your submitted CLA)
git config --global user.name "Firstname Lastname" git config --global user.email "[email protected]"
-
Submit a Pull Request
-
Fork the repository on github
-
Update submodules (
./update
) -
Create a feature branch (
git checkout -b awesome_sauce
)- Run the tests to ensure that your local environment is working
./scripts/test_submodules
- Run the tests to ensure that your local environment is working
-
Make changes on the branch:
- Adding a feature
- Add tests for the new feature
- Make the tests pass
- Fixing a bug
- Add a test/tests which exercises the bug
- Fix the bug, making the tests pass
- Refactoring existing functionality
- Change the implementation
- Ensure that tests still pass
- If you find yourself changing tests after a refactor, consider refactoring the tests first
- Adding a feature
-
Run the acceptance tests (update them if required).
-
Commit your changes (
git commit
)- Small changes per commit with clear commit messages are preferred.
-
Push to your fork (
git push origin awesome_sauce
) -
Submit a pull request in github, selecting
develop
as the target branch.
-