Skip to content

Trim Stage 11 HISTORY.md rows to match early-stage format #512

@aallan

Description

@aallan

Problem

Stage 11 rows in HISTORY.md have drifted into essay-length paragraphs (~240 words each) while Stage 1 through Stage 8 rows are one or two sentences. The table format was established as "short" in the early stages — detailed narrative lives in the Stage-intro paragraphs above each table, not inside the rows themselves.

v0.0.119 was shortened in PR #511 after CR caught the drift. The remaining Stage 11 entries should get the same treatment for consistency.

Rows to trim

The long-form rows in the Stage 11 table at HISTORY.md lines ~244–256:

Style target

Look at Stage 1 entries at lines ~17–25 for the shape. One sentence of "what shipped" plus a few distinctive details. No exhaustive function lists, no design rationale, no "eliminates the X pattern" flourishes — those belong in the CHANGELOG entry or the Stage-intro paragraph.

Expected diff: ~1,500 words → ~500 words across the Stage 11 table. Narrative context for the stage as a whole stays in the Stage 11 intro paragraph above the table.

Why now

Noticed during PR #511 review. CR pushed back twice on the v0.0.119 row being too long. The defence I tried ("every Stage 11 entry is a paragraph, this one matches") confused "the rows above me" with "the established format" — a local consistency check that rewarded the drift instead of catching it.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions