Contributing
============

.. toctree::
  :hidden:

  the_basics
  gauging_changes
  issue_triage
  release_process
  reference/reference_summary

Welcome! Happy to see you willing to make the project better. Have you read the entire
`user documentation <https://black.readthedocs.io/en/latest/>`_ yet?

.. rubric:: Bird's eye view

In terms of inspiration, *Black* is about as configurable as *gofmt* (which is to say,
not very). This is deliberate. *Black* aims to provide a consistent style and take away
opportunities for arguing about style.

Bug reports and fixes are always welcome! Please follow the
`issue template on GitHub <https://github.com/psf/black/issues/new>`_ for best results.

Before you suggest a new feature or configuration knob, ask yourself why you want it. If
it enables better integration with some workflow, fixes an inconsistency, speeds things
up, and so on - go for it! On the other hand, if your answer is "because I don't like a
particular formatting" then you're not ready to embrace *Black* yet. Such changes are
unlikely to get accepted. You can still try but prepare to be disappointed.

.. rubric:: Contents

This section covers the following topics:

- :doc:`the_basics`
- :doc:`gauging_changes`
- :doc:`release_process`
- :doc:`reference/reference_summary`

For an overview on contributing to the *Black*, please checkout :doc:`the_basics`.

If you need a reference of the functions, classes, etc. available to you while
developing *Black*, there's the :doc:`reference/reference_summary` docs.