chore(brand): em-dash sweep across prose + remove submitted CFP draft#224
Merged
Conversation
Brand alignment pass against the alanchester-brand voice rules.
196 em-dashes swept across 22 prose files. The mechanical sweep
replaces ` — ` with `. ` (period + space) and capitalizes the
following letter when it was lowercase. Code blocks and markdown
table rows are protected from substitution.
Files swept:
README.md, CONTRIBUTING.md, AGENTS.md, ARCHITECTURE.md,
SECURITY.md, docs/README.md, docs/index.md, docs/helm-values.md,
docs/explanation/{coordination,index,operations,resources}.md,
docs/how-to/index.md,
docs/how-to/install/{aks,eks,gke}.md,
docs/how-to/operate/{budget-alerts,expose-dashboard,
shared-storage}.md,
docs/tutorials/{getting-started,index}.md,
docs/reference/index.md
Post-sweep audit (`grep -nE '\. [a-z]'`) found 5 awkward
continuations after mechanical replacement. 4 are abbreviation
false positives (`e.g.`, `Approx.`, `vs.`) and left as-is. 1 was
a real awkward continuation in
docs/how-to/operate/expose-dashboard.md where the original
em-dash separated a comma-clause; restored to comma form.
Out of scope (intentional):
- internal/dashboard/templates/layout.html status colors. The
dashboard is a tool surface, not a brand surface; the semantic
UI palette (gray/amber/blue/green/red phase colors) stays.
- docs/cfp/cfp-draft.md is deleted in this PR. The CFP was
submitted, the draft no longer needs to live in the repo.
Removing it eliminates 30 em-dashes that otherwise would have
been flagged in scope.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: amcheste <13696614+amcheste@users.noreply.github.com>
The brand-alignment sweep in 25fcf54 has no associated Linear ticket. The validate.yml Linear-ref check requires either an AMC-N reference or a No-Linear-Issue trailer. PR body was updated with the trailer; this empty commit re-triggers the synchronize event on the workflow. No-Linear-Issue: brand-alignment doc cleanup, no associated Linear ticket Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> Co-Authored-By: amcheste <13696614+amcheste@users.noreply.github.com>
3 tasks
amcheste
approved these changes
May 11, 2026
This was referenced May 11, 2026
Closed
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Brand-alignment pass against the alanchester-brand voice rules. 196 em-dashes swept across 22 prose files, plus removal of the now-submitted CFP draft.
This is the prose half of the audit. The dashboard template
internal/dashboard/templates/layout.htmlis intentionally out of scope — it's a tool surface, not a brand surface, and its semantic UI palette stays.What's in this PR
Em-dash sweep (22 files)
Mechanical replacement:
—→., with capitalization of the following letter when it was lowercase. Code blocks and markdown table rows protected from substitution. Per the theming-prompt's "rendered prose vs code structure" rule.Files:
README.md,CONTRIBUTING.md,AGENTS.md,ARCHITECTURE.md,SECURITY.mddocs/README.md,docs/index.md,docs/helm-values.mddocs/explanation/{coordination,index,operations,resources}.mddocs/how-to/index.md, install (gke/aks/eks), operate (budget-alerts/expose-dashboard/shared-storage)docs/tutorials/{getting-started,index}.mddocs/reference/index.mdPost-sweep audit
The mandatory
grep -nE '\. [a-z]'audit found 5 matches:e.g.,Approx.,vs.) — left as-is.docs/how-to/operate/expose-dashboard.md: the original em-dash was bridging a comma-clause (namespace — e.g. when teams...). Mechanical sweep producednamespace. E.g. when teams...which reads as two fragments. Manually fixed tonamespace, e.g. when teams....Deletion:
docs/cfp/cfp-draft.mdThe CFP was submitted; the draft no longer needs to live in the repo. Removing it also eliminates 30 em-dashes that the sweep would have hit and that have specific rhetorical pacing worth not mechanically disturbing. The now-empty
docs/cfp/directory is removed implicitly (git doesn't track empty directories).What's intentionally NOT in this PR
internal/dashboard/templates/layout.html. The dashboard's 7-phase status palette (#f3f4f6/#374151,#fef3c7/#92400e,#dbeafe/#1e40af,#d1fae5/#065f46,#fee2e2/#991b1b) is semantic UI, not brand surface. It stays unchanged.0B0B0C, License1F4D3A) via PR chore: align badges and description to brand #220.assets/banner.pngalready exists on develop.gh repo editdecision.Voice-audit residue
After the sweep, the 4 remaining
. [a-z]matches are all real-English abbreviations. Listed here for the record so the next audit pass doesn't re-flag them:docs/explanation/operations.mdApprox.(table header)docs/explanation/resources.mde.g.(inside Mermaid diagram)docs/explanation/resources.mde.g.(parenthetical)docs/how-to/operate/expose-dashboard.mde.g.(the fixed line, comma-restored)docs/reference/api/index.mdvs.Verification
git diff develop --name-only→ 22 modified + 1 deleted. No edits tolayout.html,assets/, or.github/.🤖 Generated with Claude Code
No-Linear-Issue: brand-alignment doc cleanup, no associated Linear ticket