Skip to content

Latest commit

 

History

History
31 lines (21 loc) · 1.88 KB

CONTRIBUTING.md

File metadata and controls

31 lines (21 loc) · 1.88 KB

Contributing

Thanks for considering contributing to len8! Before you begin, take a minute to read the below information.

Expectations

  • 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.

First time contributing?

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.

Making your contribution

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:

  1. Fork the repository.
  2. Clone your fork.
  3. Run pip install -r requirements-dev.txt to install the cloned library and its development dependencies.
  4. Make your changes/additions.
  5. Run isort . && black . in the project root to format the code properly.
  6. Run nox to run all checks. If they all pass, advance to step 7, otherwise, go back to step 4.
  7. 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.