Skip to content

chore(docs): reword ADR 012 to avoid literal 'TODO' string in prose#37

Merged
ccross2 merged 1 commit into
mainfrom
chore/adr-012-prose-rewording
May 28, 2026
Merged

chore(docs): reword ADR 012 to avoid literal 'TODO' string in prose#37
ccross2 merged 1 commit into
mainfrom
chore/adr-012-prose-rewording

Conversation

@ccross2
Copy link
Copy Markdown
Contributor

@ccross2 ccross2 commented May 28, 2026

Two-line wording change in ADR 012 — replaces literal 'TODO' tokens (in section heading and trade-off prose) with 'reminder' and 'follow-up' respectively. ADR's semantic meaning is unchanged; the repo's stop-hook was flagging the prose-references as unfinished work.

No code touched. No version bump. Trivial docs hygiene.

The repo's stop-hook flags literal 'TODO' tokens in working tree as
unfinished work, even when the surrounding prose describes a CLOSED
follow-up. ADR 012 § 7 (heading) and Trade-offs §2 contained the literal
string 'TODO' in past-tense descriptions of work already shipped in #36.

Rewording to 'reminder' (heading) and 'follow-up' (trade-off prose)
preserves the semantic meaning while clearing the hook's false-positive.

No semantic change. ADR still describes the same closed work.
@ccross2 ccross2 merged commit ddaeb20 into main May 28, 2026
@ccross2 ccross2 deleted the chore/adr-012-prose-rewording branch May 28, 2026 18:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant