Skip to content

docs: daily scan fixes (2026-07-19)#390

Open
claude[bot] wants to merge 4 commits into
mainfrom
docs/daily-scan-2026-07-19
Open

docs: daily scan fixes (2026-07-19)#390
claude[bot] wants to merge 4 commits into
mainfrom
docs/daily-scan-2026-07-19

Conversation

@claude

@claude claude Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Requested by Archie McKenzie · Slack thread

Daily automated documentation scan. One subagent scanned each subsection of the docs, blog, devlog, and author profiles for CONTRIBUTING/style-guide compliance, CI hard-fail patterns, broken links, and clear typos. Only high-confidence, unambiguous fixes were applied — no voice/style rewrites, no code semantic changes.

Before / After

CI hard-fails removed (would have broken the build):

  • 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 — removed banned import Video from '@/components/Video' statements (the component is globally available in MDX; imports are CI-blocked). The one usage that needed an import replaced <Video> with a native '&lt;video controls src="..."&gt;' tag.

Integrations (mintlify, storyblok, google-drive, sanity):

  • Fixed a reference-page description that said "API reference for X" on a non-API settings page (should read "Reference for X") — 3 storyblok files.
  • Trailing whitespace in a title (mintlify).
  • Lowercased sanity/guides/meta.json's folder display title to match the repo's lowercase-folder convention.

Platform (dashboard, locadex, openapi, core):

  • Dashboard: added a missing blank line between a code fence and heading; capitalized a German formal "sie" → "Sie" in a translation-context example.
  • Locadex: fixed a Markdown list-nesting indentation bug that broke a quickstart's numbered sub-steps; moved trailing periods outside two markdown links per style; removed a stray space before punctuation.
  • OpenAPI: fixed a dangling-clause grammar error; renamed 5 endpoint page titles to match their own frontmatter descriptions and inbound cross-links (e.g. "Get branch info" → "Get branch information").
  • Core: removed backticks from a frontmatter description (backticks aren't allowed there); added missing backticks around package names in a link; fixed two parallelism/grammar issues in guides; fully italicized 6 truncated Note: callouts in type reference pages; added a missing "Default" value to an attribute line.

React:

  • Fixed a "Both X, Y, and Z" grammar error (3 items, not 2) in the Next.js quickstart.
  • Added a missing frontmatter blank line; spelled out "GT compiler" → "General Translation compiler" on first mention.
  • Added a missing Default value to a React Native plugin option's attribute line.

CLI, Node, Python: no issues found in CLI or Node; fixed a Python reference page's description that used the wrong "API reference for" lead-in on a non-API config page.

Overview: fixed a subject-verb agreement error, a link-text casing mismatch, and collapsed stray blank lines.

Blog: added a language id to a bare shell-command code fence; fixed a skipped heading level (H1 → H3 with no H2).

Devlog: fixed a comma splice with a pronoun mismatch, a malformed ordered list (tab-indented), removed 3 dead placeholder links ((#)), fixed inconsistent list punctuation, and sentence-cased a title.

Authors: added a missing occupation field (jackie); fixed a Twitter/X link that pointed to a photo lightbox instead of the profile (archie).

Flagged for human review (not touched)

A few issues surfaced that need product/source verification rather than a docs-only fix, so they were not changed:

  • docs/en-US/platform/dashboard/guides/managing-billing.mdx — a worked pricing example's arithmetic looks off ($1.06 stated vs. ~$1.60 computed from the page's own rates).
  • docs/en-US/cli/reference/commands/init.mdx vs. setup.mdx — contradictory statements about whether gt init runs gt setup.
  • docs/en-US/platform/core/guides/locale-codes.mdx — an example locale tag (fr-FR-Latn) reverses the subtag order the page itself documents (should likely be fr-Latn-FR).
  • docs/en-US/react/nextjs-quickstart.mdx — uses context where the shared component reference and sibling quickstarts use $context for the same prop.

How

45 files touched across authors/, blog/en-US/, devlog/en-US/, and docs/en-US/{cli,integrations,node,overview,platform,python,react}/. No docs-templates/ files were touched.


Generated by Claude Code

claude added 4 commits July 19, 2026 15:16
Trailing whitespace in a title, incorrect "API reference for" lead-in
on non-API reference pages (should be "Reference for"), and a stray
period placed outside a markdown link.
Missing frontmatter fields, wrong reference-description lead-in,
backticks in descriptions, link-punctuation placement, list-nesting
indentation, missing table attribute defaults, and first-mention
product-name spellout.
Shared components like <Video> are globally available in MDX and must
not be imported; these import statements are a CI hard-fail. Also
fixes a devlog title to sentence case.
Fix a skipped heading level in a blog post, remove another banned
MDX import (replaced with a native <video> tag), and drop dead
placeholder links pointing to (#).
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