Skip to content

Conversation

@RokeJulianLockhart
Copy link

@RokeJulianLockhart RokeJulianLockhart commented Nov 23, 2025

Improvements

  1. The headings are, now, semantically so (for the sake of screen readers), rather than being poor CSS3 imitations (despite being colon-delimited, which is redundant).

  2. Minor punctuation that was previously erroneously absent has been added, like a comma after “Desktop site”.

  3. The name key of the YAML preamble is consistently title case.

  4. The hyphen-minus after “domain name” is, now, an en dash, which is grammatically correct.

  5. Placeholders are commented, so that naïve issue authors do not need to worry about whether they need to retain them, because they can't render regardless.

  6. The headings are consistently titles, and therefore title case.

  7. Removing the /n at the bottom of the YAML preamble enables syntax highlighting in GH's UI.

With this, it should pass WCAG.

Unmodified

I've left no /ns between each li, due to github/markup/issues/1857.

1. The headings are, now, semantically so (for the sake of screen readers), rather than being poor CSS3 imitations (despite being colon-delimited, which is redundant).

2. Minor punctuation that was previously erroneously absent has been added, like a comma after “Desktop site”.

3. The `name` key of the YAML preamble is consistently title case.

4. The hyphen-minus after “domain name” is, now, an en dash, which is grammatically correct.

5. Placeholders are commented, so that naïve issue authors do not need to worry about whether they need to retain them, because they can't render regardless.

6. The headings are consistently titles, and therefore title case.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant