diff --git a/.claude/skills/cookbook-add-model/references/mintlify-authoring.md b/.claude/skills/cookbook-add-model/references/mintlify-authoring.md index 74e96963a..76a62a419 100644 --- a/.claude/skills/cookbook-add-model/references/mintlify-authoring.md +++ b/.claude/skills/cookbook-add-model/references/mintlify-authoring.md @@ -83,6 +83,12 @@ table is a live reference. model name + intent — e.g. `Deploy with SGLang — …` — aim for ~150–160 chars, and pack secondary keywords (variants + sizes, `Mixture-of-Experts` / architecture, target GPUs). Phrase it as a value prop, not a generic "`` is a … model" intro. +- **No `mode:` on a model page.** Leave it unset so Mintlify renders the default layout + *with* the right-hand "On this page" table of contents — every model page relies on this. + `mode: wide` drops that ToC; it's only for the category `intro.mdx` card-grid landing pages + (which have no ToC by design). The Deploy/Playground panels don't need the extra width — + they self-cap at `maxWidth: 900px` and center, which fits the default column fine. (Symptom + of a stray `mode: wide`: the page loses its right-hand ToC while its siblings keep theirs.) - Frontmatter MUST be the first thing in the file — no comment or blank line before the opening `---`. diff --git a/.claude/skills/cookbook-add-model/templates/page.mdx.tmpl b/.claude/skills/cookbook-add-model/templates/page.mdx.tmpl index bca82fb7f..9711f9e3b 100644 --- a/.claude/skills/cookbook-add-model/templates/page.mdx.tmpl +++ b/.claude/skills/cookbook-add-model/templates/page.mdx.tmpl @@ -2,7 +2,6 @@ title: __MODEL_DISPLAY__ description: "__ONE_LINER__" tag: NEW -mode: wide --- {/* TEMPLATE — instantiate via the cookbook-add-model skill, then DELETE this banner. diff --git a/.claude/skills/cookbook-review-pr/SKILL.md b/.claude/skills/cookbook-review-pr/SKILL.md index fd8fc46f8..b4468cbec 100644 --- a/.claude/skills/cookbook-review-pr/SKILL.md +++ b/.claude/skills/cookbook-review-pr/SKILL.md @@ -96,8 +96,12 @@ than restating. Launch port must match client/curl port on the same page. ### 7. Frontmatter -- Every new MDX page has `title:` and `metatags.description:` (a real one-line value prop, - not copied from another vendor). +- Every new MDX page has `title:` and a **top-level** `description:` (a real one-line value + prop, not copied from another vendor) — NOT `metatags.description` (non-canonical; the + top-level field is what renders as the subtitle and SEO meta — see mintlify-authoring). +- **No `mode: wide` on a model page** — it hides the right-hand "On this page" ToC that every + other model page has. Leave `mode` unset (the Deploy/Playground panels self-cap at 900px, so + the default column holds them fine). `mode: wide` belongs only on category `intro.mdx` grids. - `tag: NEW` only for genuine new launches; when one is added, stale `tag: NEW` on older pages should be dropped in the same PR (`grep -RlE "^tag: NEW" docs_new/cookbook/`). - MDX imports BOTH `Deployment` and `Playground` from `/src/snippets/...` (absolute). diff --git a/docs_new/cookbook/autoregressive/DeepSeek/DeepSeek-V4.mdx b/docs_new/cookbook/autoregressive/DeepSeek/DeepSeek-V4.mdx index b90c5bf95..06cb471cb 100644 --- a/docs_new/cookbook/autoregressive/DeepSeek/DeepSeek-V4.mdx +++ b/docs_new/cookbook/autoregressive/DeepSeek/DeepSeek-V4.mdx @@ -2,7 +2,6 @@ title: DeepSeek-V4 description: "Deploy DeepSeek-V4 with SGLang — verified launch commands, benchmarks, and tuning for the Flash (284B) and Pro (1.6T) Mixture-of-Experts models." tag: NEW -mode: wide --- ## Deployment