.. toctree:: :maxdepth: 3 :hidden:
Copyright and other protections apply. Please see the accompanying :doc:`LICENSE <LICENSE>` and :doc:`CREDITS <CREDITS>` file(s) for rights and restrictions governing use of this software. All rights not expressly waived or licensed are reserved. If those files are missing or appear to be modified from their originals, then please contact the author before viewing or using this software in any capacity.
There are several ways you can contribute.
You can file new issues as you find them. Please avoid duplicating issues. These may be helpful:
- Tips to Write a Good Bug Report by Soon Hui
- Writing Effective Bug Reports (PDF) by Elisabeth Hendrickson
If you're willing and able, consider submitting a pull request (PR) with a fix. There are only a few guidelines:
If it isn't already there, please add your name (and optionally your GitHub username, email, website address, or other contact information) to the
CREDITS
file:... * `Gordon the Turtle <https://github.com/GordonTheTurtle>`_ ...
Try to follow the source conventions as you observe them. (Note: I have purposely avoided aspects of PEP8, in part because I have adopted conventions developed from my experiences with other languages, but mostly because I'm growing older and more stubborn.)
Provide unit tests where feasible and appropriate. At the very least, existing tests should not fail. (There are exceptions, but if there is any doubt, they probably don't apply.)
Unit tests live in
./test
. Tests can be run with./helpers/runtests.sh
(requires tox) orpython setup.py test
.If you need me, mention me (@posita) in your comment, and describe specifically how I can help.
- If you want feedback on a work-in-progress (WIP), create a PR and prefix its title with something like, "
NEED FEEDBACK -
".
- If your PR is still in progress, but you aren't blocked on anything, prefix the title with something like, "
WIP -
".