docs/contributing/index.rst

   1 Contributing
   2 ============
   3
   4 .. toctree::
   5   :hidden:
   6
   7   the_basics
   8   gauging_changes
   9   issue_triage
  10   release_process
  11   reference/reference_summary
  12
  13 Welcome! Happy to see you willing to make the project better. Have you read the entire
  14 `user documentation <https://black.readthedocs.io/en/latest/>`_ yet?
  15
  16 .. rubric:: Bird's eye view
  17
  18 In terms of inspiration, *Black* is about as configurable as *gofmt*. This is
  19 deliberate.
  20
  21 Bug reports and fixes are always welcome! Please follow the
  22 `issue template on GitHub <https://github.com/psf/black/issues/new>`_ for best results.
  23
  24 Before you suggest a new feature or configuration knob, ask yourself why you want it. If
  25 it enables better integration with some workflow, fixes an inconsistency, speeds things
  26 up, and so on - go for it! On the other hand, if your answer is "because I don't like a
  27 particular formatting" then you're not ready to embrace *Black* yet. Such changes are
  28 unlikely to get accepted. You can still try but prepare to be disappointed.
  29
  30 .. rubric:: Contents
  31
  32 This section covers the following topics:
  33
  34 - :doc:`the_basics`
  35 - :doc:`gauging_changes`
  36 - :doc:`release_process`
  37 - :doc:`reference/reference_summary`
  38
  39 For an overview on contributing to the *Black*, please checkout :doc:`the_basics`.
  40
  41 If you need a reference of the functions, classes, etc. available to you while
  42 developing *Black*, there's the :doc:`reference/reference_summary` docs.