Skip to content

Make README more semantic. - #138

Open
beedell-roke wants to merge 1 commit into
zokugun:masterfrom
beedell-roke:patch-1
Open

Make README more semantic.#138
beedell-roke wants to merge 1 commit into
zokugun:masterfrom
beedell-roke:patch-1

Conversation

@beedell-roke

@beedell-roke beedell-roke commented Jun 19, 2026

Copy link
Copy Markdown

They're all very minor modifications:

  • All inaccessible <br/>s (and the occasional, inconsistent usage of <br />s) have been replaced by real ps, so that they wrap as expected, and screen readers announce them.

  • &gt; has been replaced by \>, so that it is more readable as text/plain.

  • The JSONC pre > code has had syntax highlighting enabled.

  • Some headings that erroneously lacked title case now utilise it (like “WebDAV”), and rsync has been codified.

  • Eastern Arabic numerals should be right-aligned, rather than centred (like Mandarin), so they have been.

  • :is(ul, ol) lis should always be spaced with a \n, else they do not wrap with a gap. This means that they'll appear different to your ps. Refer to the CommonMark (and GHFM) standards.

  • The JSON examples are block elements, so that they can be syntax-highlighted and easily duplicated into the clipboard.

In case this matters, because it appears to be a scourge nowadays, no LLMs were involved in this process whatsoever. Not that they'd need to be; it's mere markup.

- All inaccessible `<br/>`s (and the occasional, inconsistent usage of `<br />`s) have been replaced by real `p`s, so that they wrap as expected, and screen readers announce them.

- The JSONC `pre > code` has had syntax highlighting enabled.

- Some headings that erroneously lacked title case now utilise it (like “WebDAV”), and `rsync` has been codified.

- Eastern Arabic numerals should be right-aligned, rather than centred (like Mandarin), so they have been.

- `:is(ul, ol) li`s should always be spaced with a `\n`, else they do not wrap with a gap. This means that they'll appear different to your `p`s. Refer to the CommonMark (and GHFM) standards.

- The JSON examples are block elements, so that they can be syntax-highlighted and easily duplicated into the clipboard.
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