Add a third motivating example and pre-commit example

[bluemellophone]

The maintainers of pip have been working behind the scenes (pypa/pip#8437 (comment)) to add build isolation configurations to newer versions. This uses a project.toml file to ensure configuration information is provided in a scripted way, but was co-opted by the developers of Flake8 and Black before it could realistically be used for pip-only applications. As a result, if a project.toml file exists in a repository for the purposes of configuring Black it will force pip to use the more locked down build process and will cause various issues like import failures in setup.py. The natural solution is to move to the most standardized setup.cfg file for Black, but the maintainers refused to allow this option. Luckily, your project allows exactly this feature. I've added a third motivating example to your list to highlight this issue and provide a more direct link for people who are looking to jump ship from Black's stubbornness.

I've also added a description on how to do a drop-in-replacement from Black to Brunette as used by pre-commit.

Finally, I had a developer friend comment on the somewhat sensitive/risky naming convention by using the term brunette. I'm sure that this was an innocent play on words, but explaining that explicitly in the READMe with an added anti-gender-discrimination discussion may help to reassure collaborators. (Removed per request of maintainer)

[richardARPANET]

Hey @bluemellophone. Thanks for the changes 👍 . All looks great except I don't like the gender blurb.

There's nothing wrong with the hypothetical that it could be named after a hair colour, just like there's nothing wrong with most ships having a female name :)

If anyone is triggered by the name then I don't want to live on this planet anymore.

[bluemellophone]

I largely agree, the decision is rightly up to you as one of the maintainers to remove it. I thought it a bit much, but was responding to feedback from another developer.

Should I amend the PR?

[richardARPANET]

Yes please, then I can do another release so the docs update on the PyPI website.