Skip to content

Refresh stale doc references (Color Guide v3.5, completion-authority tightenings)#85

Merged
AtomicTrxn merged 1 commit into
mainfrom
lucid-mclaren-9f761f
May 17, 2026
Merged

Refresh stale doc references (Color Guide v3.5, completion-authority tightenings)#85
AtomicTrxn merged 1 commit into
mainfrom
lucid-mclaren-9f761f

Conversation

@AtomicTrxn

Copy link
Copy Markdown
Owner

Summary

Two stale doc references surfaced during a markdown audit of the repo.

  • design/Crosscue Color Guide.html — version string bumped 3.03.5. The codebase has been on v3.5 since PR #84 (Color Guide v3.5 compliance pass), but the HTML's own header still claimed v3.0.
  • docs/architecture/completion-authority.md — the "Required tightenings (after this doc lands)" section described 6 pending TODOs, but all 6 were implemented in PR #82 (E5 follow-up). Rewrote the section as "Tightenings (implemented)" with a per-item summary of what shipped, and dropped the now-irrelevant "Implementation order" section. Also fixed the issue reference format (#59 (Sprint E5)#59 (E5)) to match current E-series naming.

Other doc claims checked (not changed)

The full audit covered all 12 markdown files in the repo. Items intentionally left alone after verification:

File Flagged claim Why left as-is
README.md "Phase 1 — feature-complete" Accurate for the listed user-facing features
DEPLOYMENT.md print() logcat example Section is about Flutter framework logcat (still emits I/flutter); grep also catches Exception/Error
docs/privacy.md "Effective date: May 15" Effective date should only move when policy content changes
docs/dependency-audit.md drift "2.31.x line" claim Verified — pubspec.lock resolves drift 2.31.0, sqlite3 2.9.4, share_plus 12.0.2

Clean files: CONVENTIONS.md, CONTRIBUTING.md, ROADMAP.md, MODELS.md, crosscue/README.md, docs/index.md, ARCHITECTURE.md.

Test plan

  • grep -rn "Version 3.0\|Sprint E5\|after this doc lands" across docs returns no matches
  • No code changes, so flutter analyze / flutter test are unaffected
  • Reviewer: skim the rewritten "Tightenings (implemented)" section in docs/architecture/completion-authority.md and confirm the per-item summaries match what PR E5 follow-up: completion authority tightenings (#75) #82 actually shipped

- Color Guide HTML version string 3.0 → 3.5 to match the v3.5 spec
  already in force across the codebase (issue #83, PR #84).
- completion-authority.md: "Required tightenings (after this doc lands)"
  rewritten as "Tightenings (implemented)" with a link to PR #82, since
  all six tightenings have landed. Issue-ref format updated to current
  E-series naming (#59 Sprint E5 → #59 E5).
@AtomicTrxn
AtomicTrxn force-pushed the lucid-mclaren-9f761f branch from 5d0c85f to dc6b627 Compare May 17, 2026 05:49
@AtomicTrxn
AtomicTrxn merged commit 8cd0a9e into main May 17, 2026
3 checks passed
@AtomicTrxn
AtomicTrxn deleted the lucid-mclaren-9f761f branch May 17, 2026 05:51
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