f7d552d9b7
This is out-of-date and just a chore. I don't think this is useful to contributors and Black doesn't even have a public API.
46 lines
1.3 KiB
Markdown
46 lines
1.3 KiB
Markdown
# Contributing
|
|
|
|
```{toctree}
|
|
---
|
|
hidden:
|
|
---
|
|
|
|
the_basics
|
|
gauging_changes
|
|
issue_triage
|
|
release_process
|
|
```
|
|
|
|
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 templates on GitHub](https://github.com/psf/black/issues/new/choose) 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`
|
|
|
|
For an overview on contributing to the _Black_, please checkout {doc}`the_basics`.
|