Repository navigation
docs(research): wrapped line begins with an issue number, read as a malformed heading #13055
Description
Problem
In docs/research/lean-hardware-model-loading.md, the §2 opening paragraph names five originating
issues in sequence. The prose wraps such that a line begins with #1946, which markdownlint reads as
a malformed ATX heading (MD018 — no space after hash).
GitHub renders the line as plain text either way, since CommonMark requires a space after # for a
heading, so nothing is visually wrong. The warning is still real, and it recurs on every edit to that
paragraph because with five numbers in sequence any wrap point places one at a line start.
History
PR #13040 (which introduced the document) contained a commit claiming to fix this. That commit only
changed which issue number led the line — the defect survived. Filing this discretely so the fix is
tracked against something other than the umbrella it was discovered in.
Fix
Restructure the sentence so the continuation line begins with a word: move the issue list to the end
of the sentence and reflow.
Acceptance
grep -c '^#[0-9]' docs/research/lean-hardware-model-loading.md # → 0
grep -c '^## ' docs/research/lean-hardware-model-loading.md # → 5 (headings intact)
Related
- umbrella(optimization): large-model inference on lean hardware is scaffolded but non-functional — 7 defects #13030 — the umbrella whose audit produced the document
- docs(research): large-model inference on lean hardware — capability audit (#13030) #13040 — the PR that introduced it and carried the ineffective fix
Activity
docs(research): stop a wrapped line beginning with an issue number (#…
github-actions commentedon Jul 30, 2026
PR #13056 (merged to
Dev_new_gui) references this issue with a close keyword.If this issue is fully resolved, close it manually. If work remains, no action is needed.
mrveiss commentedon Jul 30, 2026
Fixed and merged to
Dev_new_gui. Closing manually —Closes #Nonly fires on the default branch, so a base-branch merge does not auto-close.Evidence
284c71c49b062ce733: 35 checks — 24 success, 11 skipped, 0 failuresAcceptance criteria verified against the merged file on
Dev_new_gui:The §2 sentence now places the issue list at the end so the wrapped line begins with a word, which is stable against future edits to that paragraph in a way the #13040 attempt was not.