[ijuinryukichi]

The README had grown to 586 lines, and a reader had to scroll past the format table and the recipes before reaching anything they could run.

Nothing is removed. The long analyses move behind <details>, so the page reads short and still answers "show me the numbers" in one click. The negative results are the evidence that the claims were tested — folding them is fine, deleting them is not.

What moved

• "Try it in one minute" (the public-domain, end-to-end example) now sits directly after Install, above Use. Install → run something → then learn the options.
• Deep dives folded, each with its conclusion left visible above the fold: format/TTML internals, the AMLL recipe notes, model × pairing, the Vilm head-to-head, the stable-ts comparison.
• "Known limits" goes from four long bullets to headed subsections, each leading with the limitation and the workaround, measurements folded.

Verification

check	result
visible length (outside <details>)	586 → 368 lines, 286 folded
every numeric token from the old README still present	0 dropped (counted per-token, none decreased)
internal anchors (#known-limits, #against-vilm…, #coming-from-stable-ts)	all 3 resolve
markdown inside <details> (blank line after <summary>)	8/8 blocks well-formed
tests	59 passed

The numeric-token check is the one that matters: re-wrapping paragraphs makes a line-level diff unreadable, so preservation was verified at the level of the claims rather than the lines.

🤖 Generated with Claude Code