Skip to content

Latest commit

 

History

History
38 lines (27 loc) · 1.5 KB

CONTRIBUTING.md

File metadata and controls

38 lines (27 loc) · 1.5 KB
Raw

Contributing

As an open source project, pdoc welcomes contributions of all forms. If you would like to bring the project forward, please consider contributing in the following areas:

  • Maintenance: We are incredibly thankful for individuals who are stepping up and helping with maintenance. This includes (but is not limited to) helping out other users, creating minimal examples for existing bug reports, updating documentation, fixing minor bugs that have recently been reported, reviewing pull requests, or picking up stale ones.
  • Code Contributions: We actively mark issues that we consider are good first contributions. If you intend to work on a larger contribution to the project, please come talk to us first. We are very careful not to introduce any feature creep.

Development Setup

To get started hacking on pdoc, please install a recent version of Python (we recommend at least Python 3.9). Then, do the following:

git clone https://github.com/mitmproxy/pdoc.git
cd pdoc
pip3 install -e .[dev]

Testing

If you've followed the procedure above, you already have all the development requirements installed, and you can run the basic test suite with tox:

tox

Please ensure that all patches are accompanied by matching changes in the test suite. The project strictly maintains 100% test coverage.

Documentation

Please check docs/README.md for instructions.