Thanks for considering contributing to len8! Before you begin, take a minute to read the below information.
- All code should follow PEP 8 standards
- All code should support the Python versions len8 already supported, unless there's a good reason otherwise
- Commit messages should be clear and easy to understand
- Issue and PR descriptions should be much the same
- New features and fixes should be properly tested before committing
And of course, always follow the code of conduct.
No worries, we all start somewhere. It may be best off to start with an already existing issue, or by trying to fix a simple oversight before moving onto more complicated things. Kent Dodds made a guide outlining how to contribute to open source projects.
If you are making a very small change (one or two lines), it would be better to simply supply the code in the issue itself. You will be co-authored in the relevant commit. Otherwise:
- Fork the repository.
- Clone your fork.
- Run
pip install -r requirements-dev.txt
to install the cloned library and its development dependencies. - Make your changes/additions.
- Run
isort . && black .
in the project root to format the code properly. - Run
nox
to run all checks. If they all pass, advance to step 7, otherwise, go back to step 4. - Create a PR with your changes, making sure to provide the issue number(s) it relates to.
After you've submitted your PR, feedback will be given on it. It may be approved straight away, or changes may be requested. Your PR may not be immediately merged when it's ready, but so long as it's marked as approved, you don't need to do anything.