Skip to content

B-8RZL-s-0007-steer-long-inline-code-into-fenced-blocks-to-shrink

Surfaced by T-0008 (PR #356, rumdl wiring). rumdl’s MD013 check flags prose lines that exceed 100 columns because they are a single inline-code span — a shell command, type signature, JSON shape, or path in backticks — that fmt reflow correctly refuses to break (splitting the code would corrupt it). S-0007 exempts fenced code from the line-length rule, but its inline-code equivalent has no exemption, so each irreducible line needed a hand-added entry in .rumdl.toml’s per-file-ignores (~22 files at wiring time, plus two MD032 false-positive cascades off the same lines).

The list grows every time an author writes a long command inline. Two candidate fixes (triage to pick):

  • Add a note to S-0007-markdown-formatting steering long commands and signatures into fenced code blocks (which are exempt) rather than inline backticks — shrinks the ignore list over time and reads better anyway.
  • Investigate whether rumdl can exempt inline-code-only over-long lines globally (an MD013 option, or upstream request) so the per-file list is unnecessary.

Found-in: T-0008 / D-0011-markdown-formatting-tool post-mortem.


← Back to Backlog