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
Open
fix(docs): daily scan — CI hard-fails, heading levels, broken links, prose (2026-06-28)#331claude[bot] wants to merge 1 commit into
claude[bot] wants to merge 1 commit into
Conversation
…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
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.mdxdocs/en-US/react-core-linter/index.mdxdocs/en-US/react-core-linter/guides/quickstart.mdxblog/en-US/i18n-without-translation-files.mdxdevlog/en-US/gt-react_v10_15_0.mdxdevlog/en-US/gt-react_v10_19_0.mdxdevlog/en-US/react-core-linter_v0_1_0.mdxHeading 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.mdxdocs/en-US/cli/faqs.mdxdocs/en-US/locadex/faqs.mdxdocs/en-US/locadex/mintlify.mdxdocs/en-US/sanity/faqs.mdxdocs/en-US/overview/faqs.mdxdocs/en-US/core/locales.mdxBroken internal links (2 files)
Before:
getGTwas linked to/docs/next/api/strings/use-gtin two API reference files.After:
getGTnow links to/docs/next/api/strings/get-gt.docs/en-US/next/api/strings/tx.mdxdocs/en-US/next/api/components/tx.mdxWrong variable in code example (next)
Before:
docs/en-US/next/guides/dictionaries.mdxshowed a server component callingt('greetings.hello')but the variable wasd(fromawait getTranslations()).After: Changed to
d('greetings.hello')andd('greetings.welcome').Malformed code fence (next)
Before:
docs/en-US/next/guides/cache-components.mdxhad a closing fence with four backticks.After: Fixed to three backticks.
Duplicate ordered list numbering (next)
Before:
docs/en-US/next/guides/migration.mdxhad two items numbered2..After: Third item renumbered to
3.Placeholder text removed (next)
Before:
docs/en-US/next/tutorials/dictionary/setup.mdxcontained only "🚧 This section is currently under construction. 🚧".After: Placeholder removed.
Internal link fix (node)
Before:
docs/en-US/node/guides/strings.mdxlinkedmsg()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.mdxhad a bare``` copyfence.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 missingoccupation: Software Engineerfield.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.