graphene-django/CONTRIBUTING.md
Pablo Alexis Domínguez Grau 3f813d4679
Fix ReadTheDocs builds (#1509)
* Add RTD config file

* Doc fixes to reference main branch instead of master
2024-03-29 12:11:56 +08:00

1.3 KiB

Contributing

Thanks for helping to make graphene-django great!

We welcome all kinds of contributions:

  • Bug fixes
  • Documentation improvements
  • New features
  • Refactoring & tidying

Getting started

If you have a specific contribution in mind, be sure to check the issues and projects in progress - someone could already be working on something similar and you can help out.

Project setup

After cloning this repo, ensure dependencies are installed by running:

make dev-setup

Running tests

After developing, the full test suite can be evaluated by running:

make tests

Opening Pull Requests

Please fork the project and open a pull request against the main branch.

This will trigger a series of test and lint checks.

We advise that you format and run lint locally before doing this to save time:

make format
make lint

Documentation

The documentation is generated using the excellent Sphinx and a custom theme.

The documentation dependencies are installed by running:

cd docs
pip install -r requirements.txt

Then to produce a HTML version of the documentation:

make html