Skip to content

fix(docs): daily scan — CI hard-fails, heading levels, broken links, prose (2026-06-28)#331

Open
claude[bot] wants to merge 1 commit into
mainfrom
docs/daily-scan-2026-06-28
Open

fix(docs): daily scan — CI hard-fails, heading levels, broken links, prose (2026-06-28)#331
claude[bot] wants to merge 1 commit into
mainfrom
docs/daily-scan-2026-06-28

Conversation

@claude

@claude claude Bot commented Jun 28, 2026

Copy link
Copy Markdown
Contributor

Requested by Archie McKenzie · Slack thread

Summary

Automated daily documentation quality scan for 2026-06-28. 25 files fixed across 12 subsections.

CI Hard-fail imports removed (7 files)

Before: Several MDX files contained bare import Video from '@/components/Video'; statements — a CI hard-fail that would break the build.

After: Import lines removed; <Video> tags replaced with plain markdown links preserving the video URLs.

  • docs/en-US/core/index.mdx
  • docs/en-US/react-core-linter/index.mdx
  • docs/en-US/react-core-linter/guides/quickstart.mdx
  • blog/en-US/i18n-without-translation-files.mdx
  • devlog/en-US/gt-react_v10_15_0.mdx
  • devlog/en-US/gt-react_v10_19_0.mdx
  • devlog/en-US/react-core-linter_v0_1_0.mdx

Heading level fixes — h1→h3 skips (7 files)

Before: FAQ and step-by-step pages jumped directly from the page title (h1) to ### (h3) with no ## (h2) in between.

After: All ### headings promoted to ##.

  • docs/en-US/react/faqs.mdx
  • docs/en-US/cli/faqs.mdx
  • docs/en-US/locadex/faqs.mdx
  • docs/en-US/locadex/mintlify.mdx
  • docs/en-US/sanity/faqs.mdx
  • docs/en-US/overview/faqs.mdx
  • docs/en-US/core/locales.mdx

Broken internal links (2 files)

Before: getGT was linked to /docs/next/api/strings/use-gt in two API reference files.

After: getGT now links to /docs/next/api/strings/get-gt.

  • docs/en-US/next/api/strings/tx.mdx
  • docs/en-US/next/api/components/tx.mdx

Wrong variable in code example (next)

Before: docs/en-US/next/guides/dictionaries.mdx showed a server component calling t('greetings.hello') but the variable was d (from await getTranslations()).

After: Changed to d('greetings.hello') and d('greetings.welcome').

Malformed code fence (next)

Before: docs/en-US/next/guides/cache-components.mdx had a closing fence with four backticks.

After: Fixed to three backticks.

Duplicate ordered list numbering (next)

Before: docs/en-US/next/guides/migration.mdx had two items numbered 2..

After: Third item renumbered to 3.

Placeholder text removed (next)

Before: docs/en-US/next/tutorials/dictionary/setup.mdx contained only "🚧 This section is currently under construction. 🚧".

After: Placeholder removed.

Internal link fix (node)

Before: docs/en-US/node/guides/strings.mdx linked msg() to /docs/node/api/get-messages.

After: Link updated to /docs/node/api/strings/msg.

Code fence missing language id (blog)

Before: blog/en-US/gt-next.mdx had a bare ``` copy fence.

After: Changed to ```bash copy.

Prose fixes (core)

  • docs/en-US/core/quickstart.mdx: Added missing "and" before "click"; removed extraneous "check the".
  • docs/en-US/core/class/methods/locales/requires-translation.mdx: Added missing "the".

Author frontmatter

  • authors/jackie.mdx: Added missing occupation: Software Engineer field.

How

Scanned 15 subsections in parallel using AI subagents. Applied only high-confidence fixes with unambiguous correct resolutions. Did not modify code semantics, prose voice/style, or docs-templates/ content.

…prose

- Remove `import Video` statements (CI hard-fail) in core, react-core-linter,
  blog, and devlog; replace <Video> with plain markdown video links
- Fix heading-level skips (h1→h3) across faqs.mdx files in react, cli,
  locadex (x2), sanity, overview, and core/locales — change ### to ##
- Fix broken `getGT` internal link (/use-gt → /get-gt) in next api/strings/tx
  and api/components/tx
- Fix malformed 4-backtick code fence in next/guides/cache-components
- Fix duplicate ordered list numbering (2→3) in next/guides/migration
- Remove "under construction" placeholder from next/tutorials/dictionary/setup
- Fix wrong variable name (t→d) in next/guides/dictionaries server component
- Fix `msg()` link in node/guides/strings (get-messages → strings/msg)
- Add missing language id to bare code fence in blog/gt-next (bash)
- Fix two prose issues in core/quickstart (missing "and", garbled "check the")
- Fix missing "the" in core/class/methods/locales/requires-translation
- Add missing `occupation` field to authors/jackie.mdx frontmatter

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GgFGHRt7jHpdvUNjUvuXuW
@claude claude Bot requested a review from a team as a code owner June 28, 2026 15:18
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