We'd love for you to contribute to our source code! Here are the guidelines we'd like you to follow:
If you find a bug in the source code, you can help us by submitting an issue to our GitHub Repository. Even better, you can submit a Pull Request with a fix.
Run the following commands to install the prerequisites needed to complete your pull request submission:
- Download dependencies:
dep ensure
(How to usedep
: https://github.com/golang/dep).
Before you submit your pull request consider the following guidelines:
- Search GitHub for an open or closed Pull Request that relates to your submission. You don't want to duplicate effort.
- Create separate pull requests for separate bug fixes/features.
- Make your changes in a new git branch.
- Create your patch, including appropriate test cases.
- Follow our Coding Rules.
- Run
go fmt
andgo vet
to correct any styling errors in the code. - Run
go test
to run the full test suite. - Run
dep ensure
to update the dependencies. - Push your branch to GitHub.
- In GitHub, send a pull request to
:master
. Please include a detailed description of your changes, and if/how they affect the rest of the CONIKS system. - If we suggest changes then
- Make the required updates.
- Re-run the test suite and build to ensure the code is still healthy.
- Rebase your branch and force push to your GitHub repository (this will update your Pull Request)
That's it! Thank you for your contribution!
You can safely delete your branch and pull the changes from the main (upstream) repository.
To ensure consistency throughout the source code, keep these rules in mind as you are working:
- All features or bug fixes must be tested.
- All public API methods must be documented.