Skip to content

docs: fix front-door factual errors + stale claims (pre-deploy)#181

Merged
heznpc merged 1 commit into
mainfrom
docs/front-door-consistency
Jun 9, 2026
Merged

docs: fix front-door factual errors + stale claims (pre-deploy)#181
heznpc merged 1 commit into
mainfrom
docs/front-door-consistency

Conversation

@heznpc

@heznpc heznpc commented Jun 9, 2026

Copy link
Copy Markdown
Owner

From a verified readiness audit (9-agent workflow, 36 confirmed findings, headlines re-checked by hand). Code is done (505 tests, 0 open issues); these are front-door doc fixes — factual/compliance only, NOT the deferred strategy docs.

Factual errors (were misleading users/owner)

  • README Installation claimed the CWS listing "was removed … not currently available" (full delisting). It's actually live as v1.0.1 in all locales except the US (removed 2026-05-12 over the old icon). Now matches POSITIONING (source of truth). A non-US reader was being told there's no store path when there is.
  • RELEASE_CHECKLIST pointed at store-assets/promotion/ drafts (x-thread-italian.md, plugin-directory-submission.md) that were purged and no longer exist → following the checklist hit a dead pointer. Removed it (drafts kept off-repo).

Stale (now closed)

Left intentionally: README "570+ entries" (a true conservative lower bound, not false). Deferred strategy docs (POSITIONING, quarter-focus) untouched.

Gates: 505 tests · lint · prettier · validate · check:plugin/dicts/locales/i18n/dict-coverage · full E2E (17) — all green.

🤖 Generated with Claude Code

…tency)

A verified readiness audit found the code is done (505 tests, 0 open issues)
but front-door docs had drifted. Fixes (all factual/compliance, not the
deferred strategy docs):

Factual errors (were misleading users/owner):
- README Installation said the CWS listing "was removed ... not currently
  available" (full delisting). It is actually live as v1.0.1 in all locales
  except the US (removed 2026-05-12 over the old icon). Corrected to match
  POSITIONING (the source of truth).
- RELEASE_CHECKLIST pointed at store-assets/promotion/ drafts that were purged
  and no longer exist. Removed the dead pointer (drafts are kept off-repo).

Stale (now closed):
- CHANGELOG [Unreleased] was missing #167/#170/#172/#174/#175/#176/#179/#180;
  added them.
- it.json _meta.translation_provenance + lastUpdated (and the matching
  constants.js comment, README locale-table cell) still said "v1, Spanish-
  derived regex" — it was re-translated from English in #166/#167 (overlap
  now 0.1%). Updated; regenerated plugin data accordingly.
- TESTING.md listed "E2E flows" under "What is NOT tested" — the Playwright
  E2E suite exists and runs in CI. Reframed to describe what E2E covers.
- PRIVACY_POLICY "Last updated" dateline was April 11 despite June changes.

Gates green: 505 tests, lint, prettier, validate, check:plugin/dicts/locales/
i18n/dict-coverage, full E2E (17). Deferred strategy docs (POSITIONING,
quarter-focus) untouched — owned by the separate doc-cleanup session.
@heznpc heznpc enabled auto-merge (squash) June 9, 2026 13:47
@heznpc heznpc merged commit a77e83c into main Jun 9, 2026
9 checks passed
@heznpc heznpc deleted the docs/front-door-consistency branch June 9, 2026 13:49
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