You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

23 lines
974 B

  1. # Contributing
  2. I'm open to feature suggestions and happy to review code contributions.
  3. If you are planning to contribute something larger than a small, straightforward
  4. bugfix, please open an issue so we can discuss it first. Otherwise you are risking a
  5. "no" or a "yes, but let's do it differently" to an already implemented feature.
  6. ## Code Style
  7. * Format your Python code with [black](https://black.readthedocs.io/en/stable/).
  8. * Prefer simplicity over cleverness.
  9. * If you are fixing a bug or adding a feature, add a test. Run tests before
  10. submitting pull requests.
  11. ## Adding Documentation
  12. This project uses the Markdown format for documentation. Use the `render_docs`
  13. management command to generate the HTML version of the documentation. To add a new
  14. documentation page:
  15. 1. Create the appropriate .md file under `templates/docs`
  16. 2. Generate the HTML version with `./manage.py render_docs`
  17. 3. Add the page to the navigation in `/templates/front/base_docs.html`