Packages

CSQuery is a query builder for the AWS CloudSearch structured search syntax.

Current section

Files

Jump to
csquery Contributing.md
Raw

Contributing.md

## Contributing
We value any contribution to Bamboo.ElasticEmailAdapter you can provide: a bug
report, a feature request, or code contributions. Here are our guidelines for
contributions:
* Changes *will not* be accepted without tests.
* Match our coding style; we use [Credo][] and `mix format`.
* Use a thoughtfully named topic branch that contains your change. Rebase
your commits into logical chunks as necessary.
* Use [quality commit messages][].
* Do not change the version number; when your patch is accepted and a release
is made, the version will be updated at that point.
* Submit a GitHub pull request with your changes.
### Workflow
Here's the most direct way to get your work merged into the project:
* Fork the project.
* Clone down your fork (`git clone
git://github.com/<username>/csquery.git`).
* Create a topic branch to contain your change (`git checkout -b
my_awesome_feature`).
* Hack away, add tests. Not necessarily in that order.
* Make sure everything still passes with `mix test`.
* Make sure the code is clean with `mix credo --strict`.
* Make sure your code is formatted with `mix format`.
* If necessary, rebase your commits into logical chunks, without errors.
* Push the branch up (`git push origin my_awesome_feature`).
* Create a pull request against KineticCafe/csquery and describe your change
does and the why you think it should be merged.
### Contributors
* Austin Ziegler created CSQuery inspired largely by
[csquery for Python][csquery.py].
[quality commit messages]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
[Credo]: https://github.com/rrrene/credo
[csquery.py]: https://github.com/tell-k/csquery