mirror of
https://github.com/docker/docs.git
synced 2026-11-04 10:01:00 +00:00
Linus
e22ec2bc07
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.
Docs @ Docker
Welcome to the Docker Documentation repository. This is the source for the Docker Docs Website.
Feel free to open pull requests or issues. Our docs are completely open source, and we deeply appreciate contributions from the Docker community!
Provide feedback
We’d love to hear your feedback! To submit feedback:
- Click New issue on the docs repository, or
- Click Request changes in the right column of every page on docs.docker.com, or
- Click Give feedback on every page in the docs.
To get community support, use the Docker Community Slack. Personalized support is available through the Docker Pro, Team, and Business subscriptions. See Docker Pricing for details.
If you have an idea for a new feature or behavior change in a specific aspect of Docker or have found a product bug, file an issue in the project's repository.
Contribute to Docker docs
We welcome contributions! To get started:
- CONTRIBUTING.md - Contribution workflow and setup
- STYLE.md - Writing style and content guidelines
- COMPONENTS.md - Component and shortcode usage
Copyright and license
Copyright 2013-2026 Docker, Inc., released under the Apache 2.0 license.