docs: daily scan fixes (2026-07-18) — typos, CI hard-fails, frontmatter

[claude]

Requested by Archie McKenzie · Slack thread

Summary

Daily docs scan (2026-07-18) found and fixed 25 high-confidence issues across 19 files in docs, blog, devlog, and author profiles. Everything else scanned clean.

Before / after by area

devlog (devlog/en-US/)

• 3 posts (gt-react_v10_15_0, gt-react_v10_19_0, react-core-linter_v0_1_0) had a bare import Video from '@/components/Video'; statement in the MDX body — this is a CI hard-fail (imports aren't allowed in MDX; shared components are globally available). Before: the import line, followed by <Video .../>. After: the import line removed; <Video .../> still renders since the component is global.
• gt-next_v6_3_0 and gt-react_v10_18_0: a fenced code block had no language id. After: tagged ```text.
• gt-next_v6_2_0: a two-item numbered list was tab-indented, which rendered it as a code block instead of a list. After: de-indented so it renders as 1. ... 2. ....
• gt-next_v6_10_0: fixed a comma splice ("cache keys, any cached component..." → "cache keys, so any cached component...") and a duplicated article ("happens from the reading the URL path" → "happens from reading the URL path").

blog (blog/en-US/)

• i18n-without-translation-files.mdx: removed the same bare import Video CI hard-fail.
• gt-next.mdx: fixed a code fence with no language id (``` copy → ```bash copy) and a malformed .env fence tag (```.env copy → ```env copy). Also fixed a heading-hierarchy skip — the page jumped straight to an H3 with no preceding H2, then used H4 for its subsections; promoted the section to H2 and its three subsections to H3 so the hierarchy is sequential.

platform/dashboard docs

• managing-billing.mdx: the worked billing example said translating 1,000 Markdown tokens + 3,000 context tokens costs $1.06, but the stated rates ($10/10k tokens buildtime + $0.20/1k context tokens) compute to $1.60 — fixed the number. Also fixed two double-space typos and a missing "the".
• adding-translation-context.mdx: capitalized the German formal "sie" → "Sie" in an example, and fixed an article/plural mismatch ("fill an empty Glossary and Directive fields" → "fill empty Glossary and Directive fields").
• adding-annotations.mdx: pluralized the "Note" annotation type in a table row to match its sibling rows ("Labels"/"Comments").
• project-settings.mdx: added a missing terminal period on a bullet.

platform/openapi docs

• overview.mdx: fixed a missing subject in a sentence ("must send" → "you must send").

platform/core reference

• format-message.mdx: fixed "Format.JS's" → "FormatJS's" (the library's actual name).

integrations (Storyblok)

• using-translated-content.mdx: removed a leftover reviewer-style hedge ("Confirm the exact key format against the serialization code before relying on it directly") that read as an internal draft note rather than reader-facing guidance.

author profiles (authors/)

• default.mdx and jackie.mdx were missing the required occupation frontmatter field — added Team and Software Engineer respectively.
• archie.mdx: fixed a stray /photo suffix on the Twitter/X profile link.

How

19 files touched, all conservative, mechanical, or unambiguous-typo fixes — no prose voice/style rewrites, no code semantics changed, docs-templates/ untouched. Full file list in the diff.

---

Generated by Claude Code