From f0953500dd76c939234b0cf6888b393d92520daf Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sat, 18 Jul 2026 15:21:44 +0000
Subject: [PATCH] fix: correct docs typos, CI hard-fails, and frontmatter gaps

Fixes surfaced by the daily docs scan across authors, blog, devlog, and
platform docs:

- Remove bare MDX-level `import Video` statements (CI hard-fail) from 4
  devlog/blog posts; the <Video> component is globally available.
- Add missing language ids to bare code fences (devlog x2, blog gt-next).
- Fix blog/gt-next.mdx heading hierarchy (## -> ### instead of ### -> ####)
  and a malformed `.env` fence tag.
- Fix indentation on a devlog numbered list that was rendering as a code
  block instead of an ordered list.
- Fix a comma splice and a duplicated article in devlog prose.
- Correct a billing example ($1.06 -> $1.60) that didn't match the stated
  rates in managing-billing.mdx, plus double-space/missing-word typos.
- Capitalize German formal "Sie" and fix an article/plural mismatch in
  adding-translation-context.mdx.
- Pluralize the "Note" annotation type to match its sibling rows.
- Add missing terminal period in project-settings.mdx.
- Fix missing subject ("must send" -> "you must send") in the OpenAPI
  overview.
- Drop a leftover reviewer-style "confirm against the code" hedge in the
  Storyblok guide.
- Fix "Format.JS's" -> "FormatJS's" in format-message.mdx.
- Add missing required `occupation` frontmatter field to two author
  profiles, and fix a stray /photo suffix on Archie's Twitter URL.
---
 authors/archie.mdx                                   |  2 +-
 authors/default.mdx                                  |  1 +
 authors/jackie.mdx                                   |  1 +
 blog/en-US/gt-next.mdx                               | 12 ++++++------
 blog/en-US/i18n-without-translation-files.mdx        |  2 --
 devlog/en-US/gt-next_v6_10_0.mdx                     |  2 +-
 devlog/en-US/gt-next_v6_2_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 --
 .../storyblok/guides/using-translated-content.mdx    |  2 +-
 .../utility-functions/formatting/format-message.mdx  |  2 +-
 .../platform/dashboard/guides/adding-annotations.mdx |  2 +-
 .../dashboard/guides/adding-translation-context.mdx  |  4 ++--
 .../platform/dashboard/guides/managing-billing.mdx   |  2 +-
 .../dashboard/reference/project-settings.mdx         |  2 +-
 docs/en-US/platform/openapi/overview.mdx             |  2 +-
 19 files changed, 22 insertions(+), 28 deletions(-)

diff --git a/authors/archie.mdx b/authors/archie.mdx
index b64acf16..b4504c22 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 ea49a632..1b003778 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 2ac16548..c99d0722 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/gt-next.mdx b/blog/en-US/gt-next.mdx
index 4f30479e..de620221 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
 ```
 
@@ -40,9 +40,9 @@ The goal with gt-next is to create an abundance mindset around translations. The
 - Get an API key 🔐 on our [platform](https://generaltranslation.com)
 - Read the [docs](https://generaltranslation.com/docs) 📄
 
-### What you can do with gt-next
+## What you can do with gt-next
 
-#### Format variables and plurals
+### Format variables and plurals
 
 ```javascript copy
 import { T } from 'gt-next'
@@ -67,14 +67,14 @@ export default function Page() {
 }
 ```
 
-#### Use a developer API key to see translations locally
+### 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"
 ```
 
-#### Support over 100 languages out of the box, with on-demand translation.
+### Support over 100 languages out of the box, with on-demand translation.
 
 ![landing](/images/blogs/landing.png)
 
diff --git a/blog/en-US/i18n-without-translation-files.mdx b/blog/en-US/i18n-without-translation-files.mdx
index 651dabb2..fccdf5fc 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/devlog/en-US/gt-next_v6_10_0.mdx b/devlog/en-US/gt-next_v6_10_0.mdx
index dc90ed2d..507f3d53 100644
--- a/devlog/en-US/gt-next_v6_10_0.mdx
+++ b/devlog/en-US/gt-next_v6_10_0.mdx
@@ -48,7 +48,7 @@ export default async function Home() {
 
 ### The `locale` parameter requirement
 
-Cached components use their parameters as cache keys, any cached component that contains translatable content must accept a `locale` parameter if they are to update when a user's locale changes. For example, `CachedContent` must accept a `locale` parameter to create separate cache entries for each locale. Without this parameter, the component would serve the same cached content regardless of the user's locale.
+Cached components use their parameters as cache keys, so any cached component that contains translatable content must accept a `locale` parameter if they are to update when a user's locale changes. For example, `CachedContent` must accept a `locale` parameter to create separate cache entries for each locale. Without this parameter, the component would serve the same cached content regardless of the user's locale.
 
 ### Configuration notes
 
diff --git a/devlog/en-US/gt-next_v6_2_0.mdx b/devlog/en-US/gt-next_v6_2_0.mdx
index 44172874..048ea331 100644
--- a/devlog/en-US/gt-next_v6_2_0.mdx
+++ b/devlog/en-US/gt-next_v6_2_0.mdx
@@ -48,8 +48,8 @@ export default function Page() {
 We deliberately kept `gt()` synchronous to match other i18n libraries.
 The downside was a `two-step translation process`:
 
-    1.	Register the text with the API.
-    2.	Wait for a second render to display the translated result.
+1. Register the text with the API.
+2. Wait for a second render to display the translated result.
 
 Now, thanks to the compiler, translatable content is scanned ahead of time and passed directly into `useGT()` or `getGT()` at compile time.
 This means translations are immediately available at runtime — no page refreshes.
diff --git a/devlog/en-US/gt-next_v6_3_0.mdx b/devlog/en-US/gt-next_v6_3_0.mdx
index ce7567e9..9ea11079 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
 <interpolated content>:<base64 encoded string>
 ```
 
diff --git a/devlog/en-US/gt-react_v10_15_0.mdx b/devlog/en-US/gt-react_v10_15_0.mdx
index aa608bfb..0893d547 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 `<Static>`. In [PR #1062](https://github.com/generaltranslation/gt/pull/1062), both were renamed to `derive()` and `<Derive>` 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 b3e12164..203a1c58 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 10662373..6557e165 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';
-
 <Video src='https://assets.gtx.dev/devlogs/gt-react-browser-tx-hot-reload.mp4' />
 
 ## Overview
diff --git a/devlog/en-US/react-core-linter_v0_1_0.mdx b/devlog/en-US/react-core-linter_v0_1_0.mdx
index 8f335fec..9a1d2edb 100644
--- a/devlog/en-US/react-core-linter_v0_1_0.mdx
+++ b/devlog/en-US/react-core-linter_v0_1_0.mdx
@@ -11,8 +11,6 @@ tags: ['react-core-linter', '0.1.0', 'eslint', 'linting', 'static-validation']
 
 This plugin catches common implementation errors that we have seen in the wild.
 
-import Video from '@/components/Video';
-
 <Video src='https://assets.gtx.dev/docs/react-core-linter/web-0.1.0.mp4' />
 
 ## Installation
diff --git a/docs/en-US/integrations/storyblok/guides/using-translated-content.mdx b/docs/en-US/integrations/storyblok/guides/using-translated-content.mdx
index 8c00561a..cf0a036f 100644
--- a/docs/en-US/integrations/storyblok/guides/using-translated-content.mdx
+++ b/docs/en-US/integrations/storyblok/guides/using-translated-content.mdx
@@ -22,7 +22,7 @@ This means:
 - Your existing story structure and slugs are unchanged.
 - Writes are drafts, so translations are visible in Storyblok's editor once you switch languages, and go live only when you publish the story.
 
-*Note: General Translation stores the localized value on a per-field, per-language key derived from the field name and the target language. Confirm the exact key format against the serialization code before relying on it directly; when reading through Storyblok's delivery API you do not need to know it.*
+*Note: General Translation stores the localized value on a per-field, per-language key derived from the field name and the target language; when reading through Storyblok's delivery API you do not need to know it.*
 
 ## Fetch translated content [#fetch-content]
 
diff --git a/docs/en-US/platform/core/reference/utility-functions/formatting/format-message.mdx b/docs/en-US/platform/core/reference/utility-functions/formatting/format-message.mdx
index d67acb0c..114ae726 100644
--- a/docs/en-US/platform/core/reference/utility-functions/formatting/format-message.mdx
+++ b/docs/en-US/platform/core/reference/utility-functions/formatting/format-message.mdx
@@ -11,7 +11,7 @@ description: Format ICU-style messages without a GT instance. API reference for
 
 Import `formatMessage` directly from `generaltranslation` and call it with a message string and an options object. It does not require an API key or a [GT](/docs/platform/core/reference/gt-class/constructor) instance. For instance-based formatting that inherits the instance locale, use the [`formatMessage`](/docs/platform/core/reference/gt-class-methods/formatting/format-message) method on a [`GT`](/docs/platform/core/reference/gt-class/constructor) instance instead.
 
-It is built on top of Format.JS's [`intl-messageformat`](https://formatjs.github.io/docs/intl-messageformat/) library, so it also supports number formatting, date formatting, plurals, and selects.
+It is built on top of FormatJS's [`intl-messageformat`](https://formatjs.github.io/docs/intl-messageformat/) library, so it also supports number formatting, date formatting, plurals, and selects.
 
 ```typescript
 import { formatMessage } from 'generaltranslation';
diff --git a/docs/en-US/platform/dashboard/guides/adding-annotations.mdx b/docs/en-US/platform/dashboard/guides/adding-annotations.mdx
index 1bf5d4a5..96443012 100644
--- a/docs/en-US/platform/dashboard/guides/adding-annotations.mdx
+++ b/docs/en-US/platform/dashboard/guides/adding-annotations.mdx
@@ -26,7 +26,7 @@ General Translation supports three annotation **types**: labels, notes, and comm
 | Annotation Type                                       | Best For                                                       | Usage                                                                                         |
 | ----------------------------------------------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
 | **Labels** are colored tags for categorizing entries. | **Review states** like "Needs review," "Approved," or "Legal." | Create Project-wide labels, toggle them on entries, manage them in bulk, and filter by label. |
-| **Note** is a plain-text note attached to an entry.   | Translator guidance and **internal context**.                  | Add a singular note per entry and locale.                                                     |
+| **Notes** are plain-text notes attached to an entry.  | Translator guidance and **internal context**.                  | Add a singular note per entry and locale.                                                     |
 | **Comments** are threaded discussions.                | **Team conversations** with replies, resolve, and reopen.      | Start a thread, reply, resolve it when complete, and reopen if needed.                        |
 
 
diff --git a/docs/en-US/platform/dashboard/guides/adding-translation-context.mdx b/docs/en-US/platform/dashboard/guides/adding-translation-context.mdx
index 37210aed..7cb86f62 100644
--- a/docs/en-US/platform/dashboard/guides/adding-translation-context.mdx
+++ b/docs/en-US/platform/dashboard/guides/adding-translation-context.mdx
@@ -31,7 +31,7 @@ General Translation applies reusable translation instructions through Context Gr
 
 a) **Glossary** defines **key terms**: product and brand names, features, and technical terms. *Example: Locadex is the GT agent. This product name should never be translated.*
 
-b) **Directives** define **style and tone**: audience, formality, conventions, and formatting. *Example: Use active voice, avoid jargon, and use formal “sie”*
+b) **Directives** define **style and tone**: audience, formality, conventions, and formatting. *Example: Use active voice, avoid jargon, and use formal “Sie”*
 
 All Context Groups are stored at the Organization-wide level. They can then be applied to one or more Projects.
 
@@ -97,7 +97,7 @@ When you create a Context Group from a Project, it is still created at the Organ
 
 In most cases, you should directly assign or reassign Projects to Context Groups.
 
-However, for major changes, you can also use **Export** to download a group's Glossary and Directives. Then use **Import** to fill an empty Glossary and Directive fields from a supported file. 
+However, for major changes, you can also use **Export** to download a group's Glossary and Directives. Then use **Import** to fill empty Glossary and Directive fields from a supported file.
 
 ## Set priority when groups overlap [#priority]
 
diff --git a/docs/en-US/platform/dashboard/guides/managing-billing.mdx b/docs/en-US/platform/dashboard/guides/managing-billing.mdx
index 4ebe3dc6..fa3533a3 100644
--- a/docs/en-US/platform/dashboard/guides/managing-billing.mdx
+++ b/docs/en-US/platform/dashboard/guides/managing-billing.mdx
@@ -47,7 +47,7 @@ Translation is charged per token of input at a base rate set by file format and
 - **Context** — providing extra context to guide translation adds **$0.2 per 1,000 context tokens**, set per Project.
 - **Locadex** — agent runs are priced separately, metered in **Locadex Compute Units (LCUs)** at **$5 per LCU**. An LCU measures the resources an agent uses to run end to end.
 
-*Example: translating 1,000 tokens of Markdown with 3,000 tokens of context costs $1.06.*
+*Example: translating 1,000 tokens of Markdown with 3,000 tokens of context costs $1.60.*
 
 See the [usage rates](https://generaltranslation.com/pricing/usage) page for more information.
 
diff --git a/docs/en-US/platform/dashboard/reference/project-settings.mdx b/docs/en-US/platform/dashboard/reference/project-settings.mdx
index 72afef8d..a1bc95ae 100644
--- a/docs/en-US/platform/dashboard/reference/project-settings.mdx
+++ b/docs/en-US/platform/dashboard/reference/project-settings.mdx
@@ -10,7 +10,7 @@ Project settings control how an individual Project appears and how its translati
 - Update the Project **display name**. This changes how the Project appears in the Dashboard.
 - Update the Project **source locale**. This changes the language your content is authored in, but does not update existing translations.
 - Enable the **CDN setting** to serve translations from a global CDN for faster load times.
-- Enable **AI Context**, which uses contextual information to improve AI translation quality
+- Enable **AI Context**, which uses contextual information to improve AI translation quality.
 
 ## Project ID [#project-id]
 
diff --git a/docs/en-US/platform/openapi/overview.mdx b/docs/en-US/platform/openapi/overview.mdx
index 353701b5..eac7edbb 100644
--- a/docs/en-US/platform/openapi/overview.mdx
+++ b/docs/en-US/platform/openapi/overview.mdx
@@ -40,7 +40,7 @@ Use the correct key type:
 
 - **Project (development)** with prefix `gtx-dev-`: for local and preview use, rejected by production-only endpoints
 - **Project (production)** with prefix `gtx-api-`: bound to one Project
-- **Organization** with prefix `gtx-org-`: works across Projects. When using an Organization key on Project-scoped endpoints, must send `x-gt-project-id`.
+- **Organization** with prefix `gtx-org-`: works across Projects. When using an Organization key on Project-scoped endpoints, you must send `x-gt-project-id`.
 
 See [API keys](/docs/platform/dashboard/reference/api-keys) for how to create and scope API keys.