Docs accuracy + register sweep: 45 pages verified against source

[DrAlexHarrison]

Six Opus agents swept every page on docs.saturday.fit for two things at once: factual accuracy against the shipped code, and compliance with the AI-writing ruleset captured 2026-07-23.

The coaching tab had one light register pass in #26. The API Guides tab, 25 pages and ~4,700 lines, had never had an accuracy pass at all.

What a partner hit before this

Every code sample sent a literal sk_test_abc123def456 to api.saturday.fit, which returns 401. Sandbox keys only work against a base URL issued with the key, so the copy-paste path failed for both audiences at once. The quickstart's worked totals were also 33% high, so a partner checking the math against their own output would have concluded the engine was wrong. That is the first ninety seconds of every partner evaluation. All 33 occurrences across eight pages now use an environment variable, and every Python block is syntax-checked.

Invented API surface, removed

The AI coach SSE format did not exist: real events are message_start, text_delta, tool_call, tool_result, safety_warning, error, message_end, all JSON, with no [DONE] sentinel. The tool-budget table named three tools that do not exist. batch-operations documented a metadata wrapper, a scenario label, and a top-level athlete_id, none of which exist, and promised external_id deduplication that is not implemented, so a partner retrying a failed import duplicates their roster.

Corrections with direct customer impact

• The Coach API gate is Pro Coach and above, not Business. The docs were telling paying subscribers to upgrade for access they already had. Both SDKs already had it right; the docs were the outlier.
• Coach webhook registration succeeds on any tier but only delivers on Business and Enterprise. Now stated, including that nothing on the endpoint object says so.
• Rate limits apply per account, not per key. X-RateLimit-Reset is delta seconds, not a Unix timestamp.
• X-Saturday-Data-Training does not exist and is removed from two pages. X-Saturday-Data-License is now quoted exactly.
• deployment.mdx said the docs site is hosted at api.saturday.fit, making every llms.txt, openapi.yaml, and mcp URL on it wrong.
• Both attribution.mdx examples used the dark-background asset on a light page, so the copy-paste example rendered invisible.

Coaching docs

The pages described a Coach Portal that has since moved. ?view=manage deep-links are inert, /admin/billing redirects to Stripe Connect payouts, roles live on Access & Roles. Assistants start at Pro Coach, not Head Coach. A "senior assistant" preset role was documented and does not exist. Org-paid coverage has no tier gate at all. Assignment does not grant visibility: a newly activated assistant sees the head coach's whole roster read-only immediately.

Nutrition: eco-mode is a five-position spectrum, not a toggle; there is no concentration dial; and the gluc:fruc ratio sets the blend rather than raising the carb ceiling.

AI coach guide

The endpoint returns a 404 byte-identical to an unknown route so its existence cannot be detected, while a public guide announced it. Moved to drafts/, which .mintignore excludes wholesale, and removed from nav and from the introduction feature table. Content preserved for whenever the stage moves.

Verification

Nav matches disk in both directions, every internal link resolves, 24 Python and 32 JSON blocks parse, zero em dashes, zero dead brand, no secrets or internal paths.

Not included, needs your ruling

data-policy.mdx promises a 30-day retention grace and GDPR export window that nothing implements, and DELETE is an immediate hard delete so the export window cannot exist. Left unedited: you ruled to build the purge instead. safety.mdx drops a worked example whose numbers are not producible; the teaching intent is sound and it needs real values.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Y9Yok49jHDcx2DvirP6EXT