Skip to content

Latest commit

 

History

History
44 lines (36 loc) · 1.67 KB

reviewing.rst

File metadata and controls

44 lines (36 loc) · 1.67 KB

Reviewing

Manual checks

  • The change should happen
    • The bug is a bug
    • The feature is an improvement
    • The code belongs in QTrio, not another package
      • Unless it is a workaround in QTrio temporarily or because the proper library has declined to resolve the issue.
  • Relevant bugs or features are being tested
    • The line coverage provided by automatic coverage checks are valuable but you are the only one that can decide if the proper functionality is being tested
  • Documentation updates
    • Docstrings are present and accurate for all modules, classes, methods, and functions including private ones and tests.
    • For bug fixes consider if the docs should be updated to clarify proper behavior
    • For feature additions consider if prose in the docs should be updated in addition to the docstrings.
  • The change is described for the user
    • If this is a change relevant to users, there should be a newsfragment file as follows
    • Newsfragment file name has the proper issue or PR number and change type
    • The contents describe the change well for users
    • Proper Sphinx references are used where appropriate

Automatic checks

  • Full test suite passes across:
    • operating systems
    • Python versions
    • Qt libraries
  • All code and tests lines are fully covered when running tests
  • Code is formatted per Black
  • Code passes flake8 checks
  • Docs build successfully including newsfragment, if present
  • Branch is up to date with master