Black's behavior with comments is not described in the style guide

[kylrth]

I had to go to #208 to finally find out that Black does not reformat comments. I shouldn't have to find a GitHub conversation from 2018 to find out how Black handles comments.

An explanation should be added to the readme.

[edreamleo]

I heartily second this suggestion.

Am I correct that black puts two spaces before trailing comments?

# Before:
atFile = AtFile # compatibility
# After:
atFile = AtFile  # compatibility

This is a real change. It should, at minimum, be documented somewhere.

[hugovk]

Am I correct that black puts two spaces before trailing comments?

Yes, it's in PEP 8:

An inline comment is a comment on the same line as a statement. Inline comments should be separated by at least two spaces from the statement. They should start with a # and a single space.

[edreamleo]

@hugovk Thanks for the clarification.

[ichard26]

Given how warmly received this has been by the community, I would definitely accept a patch for this!

Thanks for the suggestion!

p.s. info about how some comments get special treatment, may be moved where linters then get mad, etc. (i.e. the edge cases) should definitely be included