1
0
mirror of https://github.com/docker/docs.git synced 2026-10-23 18:09:02 +03:00
Files
docs/content/get-started
Linus e22ec2bc07 docs: fix accidental ordered-list rendering in develop-with-containers (#25974)
While reading this page, I noticed "1)" renders as a bullet point while
"2)" stays inline mid-sentence:

> This was made possible because
> 1. the processes running in each container are watching and responding
to
> file changes and 2) the files in your local project directory are
shared
>    ...

Checked the file history with `git log -L` — the original text used `1)`
and `2)` symmetrically as an inline parenthetical enumeration, all on
one line. A later commit addressing #24394 (clarifying where the files
are located) expanded the paragraph and reflowed it across multiple
lines, which put `1)` at the start of a line. Per the [CommonMark
spec](https://spec.commonmark.org/0.31.2/#ordered-list-marker), both `.`
and `)` after a digit at the start of a line are valid ordered-list
markers — so `1)` now renders as an actual list item, while `2)`, still
mid-line, stays as plain text. Inconsistent and presumably unintended.

This PR restores the sentence to a single paragraph (matching the
pre-#24394 formatting), keeping the additional clarifying text that
#24394 added. Verified in a local Markdown preview that it now renders
as plain prose with no stray list item.
2026-08-31 10:38:37 -07:00
..
2024-08-21 10:00:29 +02:00