@ambv Using Black and loving it, are you planning on using Sphinx or something else? Happy to help get things started if Sphinx.

Yes, Sphinx and RTFD would be my first choice :-)

@ambv Can you link to an example of the pep8 style doc that you were thinking? The pep itself or something else. Thanks.

PEP 8 itself is good but wordy. Google Style Guide is also good.

@ambv @carljm Giving some thought to this. In some cases, Original and After Black will be helpful to illustrate what will happen. Initially, I'm starting with something similar to:

• Guide contents: https://test-black.readthedocs.io/en/style-guide/style_guide/style_guide.html
• Rule example: https://test-black.readthedocs.io/en/style-guide/style_guide/guards.html

My current thinking is that Original/After Black examples will cut down on wordiness in PEP8.

Side by side code displays could be cool too.

@ambv If I understand correctly, this has already been superseded by "The Black Code Style", yes?