Contributions are very welcome. If you want a feature to be added, chances are it will not happen unless you actually write the code.
To get setup, run bundle install
. You
can run the full test suite with rspec spec/
or rake
.
Help us help you 😄! The more information you can provide in your github issue, the better; the very best way to report a bug is to submit a pull-request that shows off the bug you're seeing, and describes both the expected and actual behaviors in as much relevant detail as possible, as well as the steps you've taken to isolate the issue so far.
All pull requests must contain good commit messages.
All pull requests which add a feature or fix a bug must have the following extra things:
- Integration test(s). These generally go into
spec/integration/session_spec.rb
, unless it's something specific to the driver, in which case it goes inspec/integration/driver_spec.rb
. (So a test forpage.driver.resize
goes indriver_spec.rb
but a test forpage.execute_script
goes insession_spec.rb
.) - An entry into the changelog. Reference the Github issue number if there is an associated bug report. Feel free to add your name if you want to be credited.
Documentation-only pull requests must include [ci skip] in their commit messages.
- If you've worked on your changes over time, please squash the commits
in a sensible manner so that each commit is self-contained. If you
need to update a pull request with new changes, you can just
git push -f
to your branch which will overwrite previous commits that you have now squashed. - Please try to pay attention to and follow the existing coding style.
Thanks! It's really great when people help with Apparition's development.