Skip to content

Latest commit

 

History

History
25 lines (17 loc) · 1.24 KB

CONTRIBUTING.rst

File metadata and controls

25 lines (17 loc) · 1.24 KB

Contributing to SPORCO

Contributions to SPORCO are welcome. Before starting work, please contact the maintainers, either via email or the GitHub issue system, to discuss the relevance of your contribution and the most appropriate location within the existing package structure.

Please follow these guidelines in developing code intended for SPORCO:

  • Set up your editor to remove trailing whitespace.

  • Follow PEP 8 coding conventions, with minor deviations as present in the existing code in SPORCO. Flake8 is a useful tool for checking coding style; to check module.py do:

    flake8 --ignore=D202,E303,D413,D402 module.py
    
  • All code must be thoroughly documented, adequately commented, and have corresponding pytest unit tests.

Guides for Other Projects

Some other open source projects have detailed contributing guides that are worth consulting for recommended good practices, technical details of git usage, etc.: