Skip to content

docs: daily scan fixes — CI hard-fails, frontmatter, typos, code fences - #405

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

docs: daily scan fixes — CI hard-fails, frontmatter, typos, code fences#405
claude[bot] wants to merge 5 commits into
mainfrom
docs/daily-scan-2026-07-22

Conversation

@claude

@claude claude Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Requested by Archie McKenzie · Slack thread

Summary

Daily automated docs-quality scan. 15 subagents each swept one docs subsection (CLI, Node, Python, React + frameworks + reference, Platform/Core + Dashboard + Locadex + OpenAPI, integrations, overview/authors/blog, devlog) for CONTRIBUTING.md compliance, CI hard-fail patterns, prose typos, and broken markdown. This PR applies only the high-confidence, mechanical fixes found.

Before → After, by area

CI hard-fails (would have broken the build)

  • blog/i18n-without-translation-files.mdx, devlog/gt-react_v10_15_0.mdx, devlog/gt-react_v10_19_0.mdx, devlog/react-core-linter_v0_1_0.mdx — removed a bare import Video from '@/components/Video' statement in the MDX body. Shared components are globally available per CONTRIBUTING.md; importing them is blocked by CI.

Frontmatter

  • authors/jackie.mdx, authors/default.mdx — added the required occupation field.
  • authors/archie.mdx — fixed the twitter field, which pointed at a photo-lightbox URL instead of the profile.
  • docs/integrations/mintlify/guides/managing-translations.mdx — stripped a trailing space from the frontmatter title.

Code fences missing a language id

  • blog/gt-next.mdx ( ``` copy ```bash copy), blog/multilingual-nextjs-seo.mdx (×2), blog/plurals.mdx (×4), devlog/gt-next_v6_3_0.mdx, devlog/gt-react_v10_18_0.mdx — all tagged text or bash to match their content.

Broken/placeholder links

  • devlog/gt-i18n_v0_1_0.mdx — removed two dead [...](#) placeholder links around mFallback()/gtFallback()/msg().
  • docs/platform/locadex/guides/configuring-workflows.mdx, docs/platform/locadex/guides/managing-languages.mdx — moved link punctuation (period) outside the brackets, per the repo's link-punctuation rule.

Factual / wording corrections

  • docs/platform/dashboard/guides/managing-billing.mdx — fixed a worked-example arithmetic error: 1,000 Markdown tokens ($1.00) + 3,000 context tokens ($0.60) = $1.60, not $1.06.
  • docs/react/nextjs-quickstart.mdx — fixed a wrong prop name in a troubleshooting example: the <T> context prop is $context, not context (confirmed against the component reference and every other quickstart).
  • docs/platform/dashboard/get-started.mdx — corrected a feature name to match its actual page: Force retranslate, not "Force retranslation".
  • docs/platform/dashboard/guides/adding-translation-context.mdx — capitalized formal German "Sie", fixed a noun-number mismatch ("Directive fields" → "Directives fields"), and fixed a wrong preposition ("apply for" → "apply to").
  • docs/platform/dashboard/reference/project-settings.mdx, docs/platform/openapi/overview.mdx, docs/platform/index.mdx, docs/platform/core/guides/translating-files.mdx — minor grammar/punctuation fixes (missing period, missing sentence subject, product-name casing, an ungrammatical verb list).
  • docs/integrations/storyblok/guides/using-translated-content.mdx — removed a leftover reviewer note-to-self referencing internal serialization code.
  • 6 pages under docs/platform/core/reference/types/ — fixed *Note:* callouts where only the word "Note:" was italicized instead of the whole sentence.

How

Read-only scan by 15 parallel subagents (one per docs subsection), each returning a structured, conservative findings list against this repo's CONTRIBUTING.md. All findings were manually verified (including re-deriving the billing arithmetic and cross-checking the $context prop and "Force retranslate" name against their reference pages) before being applied. No prose was rewritten for voice/style, no code semantics were changed, and docs-templates/ was left untouched.


Generated by Claude Code

claude added 3 commits July 22, 2026 15:23
… fences

- Remove CI-blocking `import Video` statements from 4 blog/devlog MDX files
  (shared components are globally available and must not be imported)
- Add missing `occupation` frontmatter field to 2 author profiles
- Fix broken twitter profile link (was pointing at a photo lightbox URL)
- Add language identifiers to 9 bare fenced code blocks across blog/devlog
- Fix link punctuation (period inside brackets) in 2 Locadex guides
- Fix incomplete Note-callout italics on 6 Core reference type pages
- Correct a billing example arithmetic error ($1.06 -> $1.60)
- Fix a wrong prop name (`context` -> `$context`) in the Next.js quickstart
- Remove a leftover reviewer note-to-self from the Storyblok guide
- Remove 2 dead placeholder links (`[...](#)`) in a devlog entry
- Various grammar/wording fixes (missing periods, wrong prepositions,
  incorrect feature name, subject-less sentence, mismatched noun number)

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018i3sWpRcc4bRbqN7d8WGLn
# Conflicts:
#	docs/en-US/platform/locadex/guides/configuring-workflows.mdx
…07-22

# Conflicts:
#	docs/en-US/platform/dashboard/guides/adding-translation-context.mdx
#	docs/en-US/platform/dashboard/guides/managing-billing.mdx
@moss-bryophyta
moss-bryophyta enabled auto-merge (squash) July 28, 2026 16:28
claude added 2 commits July 29, 2026 19:01
…07-22

# Conflicts:
#	docs/en-US/integrations/mintlify/guides/managing-translations.mdx
#	docs/en-US/react/nextjs-quickstart.mdx
…07-22

# Conflicts:
#	docs/en-US/platform/core/reference/types/file-to-translate.mdx
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