[Docs] Restore right-hand ToC on the DeepSeek-V4 cookbook page (#27830)

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-10 11:58:02 -07:00
parent 3600a9ac5f
commit 99258b2f1e
4 changed files with 12 additions and 4 deletions
@@ -83,6 +83,12 @@ table is a live reference.
    model name + intent — e.g. `Deploy <Model> 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 "`<Model>` 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 `---`.

@@ -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.
@@ -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).
@@ -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