Your contributions to Ginkgo are essential for its long-term maintenance and improvement.
- Please open an issue first - describe what problem you are trying to solve and give the community a forum for input and feedback ahead of investing time in writing code!
- Ensure adequate test coverage:
- When adding to the Ginkgo library, add unit and/or integration tests (under the
integration
folder). - When adding to the Ginkgo CLI, note that there are very few unit tests. Please add an integration test.
- When adding to the Ginkgo library, add unit and/or integration tests (under the
- Update the documentation. Ginko uses
godoc
comments and documentation on thegh-pages
branch. If relevant, please submit a docs PR to that branch alongside your code PR.
Thanks for supporting Ginkgo!
Fork the repo, then:
go get github.com/onsi/ginkgo
go get github.com/onsi/gomega/...
cd $GOPATH/src/github.com/onsi/ginkgo
git remote add fork [email protected]:<NAME>/ginkgo.git
ginkgo -r -p # ensure tests are green
go vet ./... # ensure linter is happy
- go to a new branch
git checkout -b my-feature
- make your changes
- run tests and linter again (see above)
git push fork
- open PR 🎉