Skip to content

Site-wide em-dash prose style: decide house convention or run a dedicated de-dash pass #338

Description

@SUaDtL

Both anti-slop design reviewers (content-source and rendered-dist passes, 2026-07-18) flag the em-dash-as-sentence-separator style as a core §3.A violation across ~114 of ~134 rendered docs-site pages. It is a pre-existing house convention, not introduced by any recent diff, so it was deliberately NOT folded into the Pi release PR (#313).

Decision needed, one of:

  1. Accept as house style — record the decision; design reviews stop flagging it site-wide.
  2. Dedicated de-dash pass — one sweep over site/src/content/docs/** and generator strings (site/scripts/gen.ts host note etc.), replacing prose-separator em-dashes with periods/commas/colons, then a lint in npm test (grep for — outside code/quote contexts) to hold the line.

Related minor finding to fold into whichever path: the changelog generator renders ## [2.9.0] — 2026-07-12 where the source CHANGELOG.md uses a plain hyphen — one-line fidelity fix in render-changelog.

Metadata

Metadata

Assignees

No one assigned

    Labels

    sev:lowTribunal/triage: low severity

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions