docs/contributing/index.md

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