Nice. I suspect this annotation can be put to use in quite a few places elsewhere too. Excellent enhancement IMO.

Question

I only added green/red for examples that are comparatively marked as correct or wrong (or similar). I left the other examples unmarked. But I think we could also mark those green, because they too are examples of good/allowed style. Thoughts?

Would look like this:

• https://hugovk-peps.readthedocs.io/en/green-red2/pep-0008/

And give us extra green in places like:

• https://hugovk-peps.readthedocs.io/en/green-red2/pep-0008/#module-level-dunder-names

Thank you! This looks useful for me as for a non-colourblind reader. I'm sure it could be made more accessible, perhaps in a dedicated PR.

I think we could also mark those green, because they too are examples of good/allowed style.

It does look better to me :)

IMO, in that case the outdated with example should be red (or left without colour): https://hugovk-peps.readthedocs.io/en/green-red2/pep-0008/#maximum-line-length
(perhaps with a comment that it's only for Python 3.10 and below)

Thanks, I've updated this PR to add those extra ones.

MO, in that case the outdated with example should be red (or left without colour): hugovk-peps.readthedocs.io/en/green-red2/pep-0008/#maximum-line-length
(perhaps with a comment that it's only for Python 3.10 and below)

Good point, I've left this one uncoloured:

https://pep-previews--3567.org.readthedocs.build/pep-0008/#maximum-line-length

Good point, I've left this one uncoloured

What about a yellow border for examples like this?

The diff is a little difficult to read, but I'll trust that there aren't any content changes. The red/green borders are very nice! Thanks for doing this.

Good point, I've left this one uncoloured

What about a yellow border for examples like this?

Something like this? https://pep-previews--3567.org.readthedocs.build/pep-0008/#maximum-line-length

The diff is a little difficult to read, but I'll trust that there aren't any content changes. The red/green borders are very nice! Thanks for doing this.

Correct, no content changes.

Sphinx is stricter for .. code-block:: (needed for the class) than ::, so I had to adjust some indents.

Re: yellow - yes, exactly. It looks pretty good in both light and dark themes. Thanks!

Thanks for the reviews! Let's merge this, and we can then add to other PEPs where appropriate.