From 9aeeb405b9249bd4e7c3427233e7f8314754ca2e Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 21 Jul 2026 15:19:10 +0000 Subject: [PATCH] =?UTF-8?q?fix:=20daily=20docs=20scan=20=E2=80=94=20CI=20h?= =?UTF-8?q?ard-fails,=20broken=20prop=20names,=20style=20fixes?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Remove bare `import Video` statements in 3 devlog entries and 1 blog post (CI hard-fails on import/export in MDX body) - Fix wrong `context` prop -> `$context` in the Next.js quickstart troubleshooting section, and `GT_API_KEY` -> `GT_DEV_API_KEY` in two Next.js quickstart dev-setup snippets, to match the documented config/credentials reference - Fix a mismatched cross-reference in the React Core linter rules page (getGT link pointed at the Node SDK instead of the Next.js function) - Add missing `occupation` frontmatter field on two author profiles; fix a malformed twitter URL on another - Add missing code-fence language tags, fix link punctuation, drop a leftover placeholder anchor and an editorial JSX comment, and other small grammar/formatting fixes across docs, blog, and devlog content --- authors/archie.mdx | 2 +- authors/default.mdx | 1 + authors/jackie.mdx | 1 + blog/en-US/ai-chatbot.mdx | 2 +- blog/en-US/gt-next.mdx | 4 ++-- blog/en-US/i18n-without-translation-files.mdx | 2 -- blog/en-US/multilingual-nextjs-seo.mdx | 5 ++--- blog/en-US/plurals.mdx | 8 ++++---- devlog/en-US/gt-i18n_v0_1_0.mdx | 4 ++-- devlog/en-US/gt-next_v6_3_0.mdx | 2 +- devlog/en-US/gt-react_v10_15_0.mdx | 2 -- devlog/en-US/gt-react_v10_18_0.mdx | 2 +- devlog/en-US/gt-react_v10_19_0.mdx | 2 -- devlog/en-US/react-core-linter_v0_1_0.mdx | 2 -- docs/en-US/cli/quickstart.mdx | 1 + .../mintlify/guides/managing-translations.mdx | 2 +- docs/en-US/platform/core/guides/translating-files.mdx | 2 +- docs/en-US/platform/core/quickstart.mdx | 2 +- .../platform/core/reference/gt-class/constructor.mdx | 4 ++-- .../dashboard/guides/adding-translation-context.mdx | 4 ++-- .../platform/dashboard/reference/project-settings.mdx | 2 ++ docs/en-US/platform/locadex/guides/auto-merging-prs.mdx | 2 +- .../platform/locadex/guides/configuring-workflows.mdx | 4 ++-- docs/en-US/platform/locadex/guides/managing-languages.mdx | 2 +- .../python/reference/functions/extract-variables.mdx | 2 +- docs/en-US/react/guides/configuring.mdx | 1 + docs/en-US/react/nextjs-pages-router-quickstart.mdx | 2 +- docs/en-US/react/nextjs-quickstart.mdx | 8 ++++---- docs/en-US/react/reference/lint-rules.mdx | 2 +- 29 files changed, 38 insertions(+), 41 deletions(-) diff --git a/authors/archie.mdx b/authors/archie.mdx index b64acf169..b4504c222 100644 --- a/authors/archie.mdx +++ b/authors/archie.mdx @@ -4,7 +4,7 @@ avatar: /static/avatars/archie.png occupation: CEO company: General Translation email: archie@generaltranslation.com -twitter: https://x.com/archiemckenzie_/photo +twitter: https://x.com/archiemckenzie_ linkedin: https://www.linkedin.com/in/archie-mckenzie --- diff --git a/authors/default.mdx b/authors/default.mdx index ea49a6325..1b0037782 100644 --- a/authors/default.mdx +++ b/authors/default.mdx @@ -1,6 +1,7 @@ --- name: Team avatar: /static/avatars/logo.png +occupation: Team company: General Translation email: archie@generaltranslation.com twitter: https://x.com/generaltxn diff --git a/authors/jackie.mdx b/authors/jackie.mdx index 2ac16548a..c99d07226 100644 --- a/authors/jackie.mdx +++ b/authors/jackie.mdx @@ -1,6 +1,7 @@ --- name: Jackie Chen avatar: /static/avatars/jackie.png +occupation: Software Engineer company: General Translation email: jackie@generaltranslation.com twitter: https://x.com/Some_Jackie diff --git a/blog/en-US/ai-chatbot.mdx b/blog/en-US/ai-chatbot.mdx index 8f305e1fb..2ddb0aca4 100644 --- a/blog/en-US/ai-chatbot.mdx +++ b/blog/en-US/ai-chatbot.mdx @@ -200,7 +200,7 @@ const gt = useGT(); That was it! All of the text in the chatbot was now internationalized and available in any language. -## Deploying to Production +## Deploying to production Deploying to production was even easier. I swapped out my `GT_API_KEY` environment variable with a production API key and ran the translate command: diff --git a/blog/en-US/gt-next.mdx b/blog/en-US/gt-next.mdx index 4f30479e2..310bedb8a 100644 --- a/blog/en-US/gt-next.mdx +++ b/blog/en-US/gt-next.mdx @@ -8,7 +8,7 @@ tags: ['guide', 'internationalization', 'nextjs', 'gt-next'] **Internationalization (i18n) sucks. We're building a Next.js library, gt-next, to make it easier.** Today we're launching it in open beta. -``` copy +```bash copy npm i gt-next ``` @@ -69,7 +69,7 @@ export default function Page() { #### Use a developer API key to see translations locally -```.env copy +```env copy GT_API_KEY="gtx-dev-cae62d6fe1e33bda603c9a2926ab0fb8" GT_PROJECT_ID="abcdef12-3456-789a-bcd4-ef123456789a" ``` diff --git a/blog/en-US/i18n-without-translation-files.mdx b/blog/en-US/i18n-without-translation-files.mdx index 651dabb25..fccdf5fc3 100644 --- a/blog/en-US/i18n-without-translation-files.mdx +++ b/blog/en-US/i18n-without-translation-files.mdx @@ -6,8 +6,6 @@ authors: [jackie] tags: ['guide', 'internationalization', 'nextjs', 'i18n', 'gt-next', 'translation-files', 'developer-experience'] --- -import Video from '@/components/Video'; - Everyone who's internationalized a JavaScript app knows the workflow. You install an i18n library, create an `en.json` file, pull every user-facing string out of your components, assign each one a key, and reference the key where the string used to be. Then you duplicate that JSON file for every language you support. `es.json`, `fr.json`, `ja.json`. At first, it's fine. Thirty strings, three languages, 90 entries. diff --git a/blog/en-US/multilingual-nextjs-seo.mdx b/blog/en-US/multilingual-nextjs-seo.mdx index d73c95efb..51cd16701 100644 --- a/blog/en-US/multilingual-nextjs-seo.mdx +++ b/blog/en-US/multilingual-nextjs-seo.mdx @@ -33,7 +33,7 @@ Search engines need separate, crawlable URLs to index each language version inde This means **locale-in-the-URL** — not cookies, not query parameters, not `Accept-Language` detection alone. -``` +```text ✅ generaltranslation.com/en/about ✅ generaltranslation.com/fr/about ✅ generaltranslation.com/es/about @@ -46,7 +46,7 @@ This means **locale-in-the-URL** — not cookies, not query parameters, not `Acc First, nest your pages under a `[locale]` dynamic segment: -``` +```text app/ └── [locale]/ ├── layout.tsx @@ -80,7 +80,6 @@ It's one of the simplest and most impactful things you can do for accessibility Without it, screen readers guess the language (often wrong), and search engines have less confidence in their language classification. -{/* useLocale works in both client and server rendered components, just not in async components */} gt-next provides the `useLocale` hook that makes this trivial in your root layout: ```tsx title="app/[locale]/layout.tsx" diff --git a/blog/en-US/plurals.mdx b/blog/en-US/plurals.mdx index f3c3a64c2..032a27935 100644 --- a/blog/en-US/plurals.mdx +++ b/blog/en-US/plurals.mdx @@ -12,7 +12,7 @@ layout: PostLayout We often encounter apps that display awkward messages like: -``` +```text You have 1 new message(s) ``` @@ -87,7 +87,7 @@ pluralize(2, 'child', 'children') // "children" But what if you need more complicated logic, like: -``` +```text "No one is watching" "1 person is watching" "2 people are watching" @@ -168,7 +168,7 @@ languages like Arabic and Polish have more than just these two forms. For example, an English-speaking user might expect: -``` +```text "No one is watching" "1 person is watching" "2 people are watching" @@ -177,7 +177,7 @@ For example, an English-speaking user might expect: Whereas an Arabic-speaking user might expect different expressions for singular, dual (when the count is exactly two things), and small and large plural forms: -``` +```text "لا أحد يشاهد" "1 شخص يشاهد" "2 شخصان يشاهدان" diff --git a/devlog/en-US/gt-i18n_v0_1_0.mdx b/devlog/en-US/gt-i18n_v0_1_0.mdx index 528ab2a2b..151a96931 100644 --- a/devlog/en-US/gt-i18n_v0_1_0.mdx +++ b/devlog/en-US/gt-i18n_v0_1_0.mdx @@ -16,8 +16,8 @@ Though `generaltranslation` is also a runtime-agnostic library, it is—by desig ## What's Included -- **[`msg()`](#)** - String registration and variable interpolation -- **[`mFallback()`](#)** and **[`gtFallback()`](#)** - Migration helpers for incremental adoption +- **`msg()`** - String registration and variable interpolation +- **`mFallback()`** and **`gtFallback()`** - Migration helpers for incremental adoption --- diff --git a/devlog/en-US/gt-next_v6_3_0.mdx b/devlog/en-US/gt-next_v6_3_0.mdx index ce7567e97..9ea110790 100644 --- a/devlog/en-US/gt-next_v6_3_0.mdx +++ b/devlog/en-US/gt-next_v6_3_0.mdx @@ -63,7 +63,7 @@ export default function Page() { To support interpolation, the `msg()` function returns an encoded message instead of a plain string. The format looks like this: -``` +```text : ``` diff --git a/devlog/en-US/gt-react_v10_15_0.mdx b/devlog/en-US/gt-react_v10_15_0.mdx index aa608bfb9..0893d5473 100644 --- a/devlog/en-US/gt-react_v10_15_0.mdx +++ b/devlog/en-US/gt-react_v10_15_0.mdx @@ -5,8 +5,6 @@ authors: [ernest] tags: ['gt-react', 'derive', 'tagged-template', 'i18n'] --- -import Video from '@/components/Video'; - ## The `declareStatic()` → `derive()` rename This release is the first to ship with the new `derive()` name. Previously, this function was called `declareStatic()` and the JSX component was ``. In [PR #1062](https://github.com/generaltranslation/gt/pull/1062), both were renamed to `derive()` and `` for clarity. diff --git a/devlog/en-US/gt-react_v10_18_0.mdx b/devlog/en-US/gt-react_v10_18_0.mdx index b3e121641..203a1c583 100644 --- a/devlog/en-US/gt-react_v10_18_0.mdx +++ b/devlog/en-US/gt-react_v10_18_0.mdx @@ -94,7 +94,7 @@ function StatusMessage({ isMasculine }) { At build time, the CLI sees the `derive()` call and registers two separate source entries, each producing its own translation: -``` +```text "I am tired" ($context: "inflect as masculine") → "Estoy cansado" "I am tired" ($context: "inflect as feminine") → "Estoy cansada" ``` diff --git a/devlog/en-US/gt-react_v10_19_0.mdx b/devlog/en-US/gt-react_v10_19_0.mdx index 106623733..6557e1652 100644 --- a/devlog/en-US/gt-react_v10_19_0.mdx +++ b/devlog/en-US/gt-react_v10_19_0.mdx @@ -5,8 +5,6 @@ authors: [ernest] tags: ['gt-react', 'browser', 'hot-reload', 'dev-experience', 'i18n'] --- -import Video from '@/components/Video'; -