2016-05-23 21:08:41 -07:00
|
|
|
# Contributing
|
|
|
|
|
|
|
|
We love pull requests from everyone. By participating in this project, you
|
|
|
|
agree to abide by the golang [code of conduct].
|
|
|
|
|
|
|
|
[code of conduct]: https://golang.org/conduct
|
|
|
|
|
|
|
|
The basic steps begin with a clone this repo:
|
|
|
|
|
2016-09-09 12:58:19 -07:00
|
|
|
$ git clone https://github.com/dmmcquay/vain.git $GOPATH/src/github.com/dmmcquay/vain
|
2016-05-23 21:08:41 -07:00
|
|
|
|
|
|
|
then set up to push up to your hosting service of choice, e.g.:
|
|
|
|
|
2016-09-09 12:58:19 -07:00
|
|
|
$ cd $GOPATH/src/github.com/dmmcquay/vain
|
2016-05-23 21:08:41 -07:00
|
|
|
$ git remote add mine git@github.com/you/vain.git
|
|
|
|
|
|
|
|
add a feature and some tests then run the tests, check your formatting:
|
|
|
|
|
2016-09-09 12:58:19 -07:00
|
|
|
$ go test github.com/dmmcquay/vain
|
|
|
|
$ go vet github.com/dmmcquay/vain
|
|
|
|
$ golint github.com/dmmcquay/vain
|
2016-05-23 21:08:41 -07:00
|
|
|
|
|
|
|
If things look good and tests pass commit and push to your remote:
|
|
|
|
|
|
|
|
$ git add (files you changed)
|
|
|
|
$ git commit -m "Job's done"
|
|
|
|
$ git push mine feature
|
|
|
|
|
|
|
|
|
2016-09-09 12:58:19 -07:00
|
|
|
Push to your fork and at this point you're waiting on us. We will comment on
|
|
|
|
the pull request request within three business days (and, typically, one
|
|
|
|
business day). We may suggest some changes or improvements or alternatives.
|
2016-05-23 21:08:41 -07:00
|
|
|
|
|
|
|
Some things that will increase the chance that your pull request is accepted:
|
|
|
|
|
|
|
|
* Write tests.
|
|
|
|
* follow good Go style, including [effective go], running [go vet] and [golint].
|
|
|
|
* Write a [good commit message][commit].
|
|
|
|
|
|
|
|
[effective go]: https://golang.org/doc/effective_go.html
|
|
|
|
[go vet]: https://golang.org/cmd/vet/
|
|
|
|
[golint]: https://github.com/golang/lint
|
|
|
|
[commit]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
|
|
|
|
|
|
|
|
contribution guidelines borrowed from [factory girl rails].
|
|
|
|
|
|
|
|
[factory girl rails]: https://github.com/thoughtbot/factory_girl_rails
|