I love pull requests from everyone!
First you'll need to make sure you have go version 1.7 or later. golang.org has some good instructions on installing Go.
If you will be contributing, then you'll want to fork the repository.
Once you've forked it, then you can clone the source:
$ git clone [email protected]:<your-username>/<repository-name>.git
Fetch the required dependencies:
$ script/bootstrap
Before you do any changes, make sure the tests pass:
$ script/test
Make your change. Add tests for your change. Make the tests pass:
$ script/test
Push to your fork and submit a pull request.
At this point you're waiting on me. I try to be responsive to pull requests, but you know life can get in the way. I may suggest some changes or improvements or alternatives.
Some things that will increase the chance that your pull request is accepted:
- Write tests.
- Write a good commit message.
-
Update the
CHANGELOG.md
. See keepachangelog.com for info. -
Commit
CHANGELOG.md
-
Copy the current change log entry for the version to be released.
-
Tag the new version. Example:
$ git tag v0.1.0
-
Push up the commit and tag:
$ git push ... $ git push --tags ...
-
Go to the releases page
- Click on "Edit"
- The name should match the tag. e.g.
v0.1.0
- Paste in the change log entry.
- Save.