Felix Hildén

I tested it: Sphinx does not accept your format. It warns about "literal block expected; none found" and outputs ordinary text. So are you using some other tool?

I meant that the unedited example you described was not accepted by Sphinx, producing the error I provided. I did not format with black before building.

As this seems a bit controversial, maybe we should instead try to respect user-inserted parentheses, like in math expressions and other cases like in a [comment above](https://github.com/psf/black/issues/449#issuecomment-517237014) already: ```python a...

I'm not 100 % sure if we should do it. I'd say I'm moderately in favor of it 😄 But *if* we do, my preference would be no blank lines:...

Well that's a can of worms too 😅 but I definitely prefer either on one line, or all at the same level, like I wrote above.

@tolomea Your suggestion (without the docstrings) is being tracked in #902.

Module docstrings are already being handled by #2996. It's not a big stretch to start applying that elsewhere as well. We'll just have to agree to do it. And us...

All for it! Related to #2338 and other similar parens issues.

Can confirm this still happens even with experimental string processing. Here's a [playground](https://black.vercel.app/?version=stable&state=_Td6WFoAAATm1rRGAgAhARYAAAB0L-Wj4ADuAJldAD2IimZxl1N_WkRsVtdQb4Tqd369cLgVs2olGh6SvD2RoeO_pRyVR1-p6GjbePfZyz1OXc9FNC69osvnPlfj0vyQ96cj79y43dGmk-poMtQ2_9ny3ICI0V4fnqmz8X0j5gT55n7Jk38NkCkBNWPidOcAji7FxJav0FusleoJowj7JecC4ZYqmYGll0cPFr8MFdZWDVJn4dkmMAAAAADzYa8Si-ESDgABtQHvAQAA8kTsO7HEZ_sCAAAAAARZWg==) for convenience.

Any updates will be posted here!