Skip to content

[docs] Rotate popular models on the landing pages, lead the Cookbook nav with Kimi - #32835

Merged
zijiexia merged 2 commits into
mainfrom
claude/cookbook-popular-models-carousel
Jul 30, 2026
Merged

zijiexia merged 2 commits into
mainfrom
claude/cookbook-popular-models-carousel

Conversation

@zijiexia

@zijiexia zijiexia commented Jul 30, 2026 •

Copy link
Copy Markdown
Collaborator

Motivation

Three things on the docs / Cookbook landing surfaces:

  1. index.mdx hard-coded a ~180-line Kimi-K3 hero. Featuring a different model means rewriting the page.
  2. cookbook/intro.mdx had no model entrance at all — a reader landing on the Cookbook home sees three category cards and no sign of which models are worth opening.
  3. The autoregressive nav led with Qwen, so the models we most want read sat mid-list.

Modifications

Popular models, one list, two shapes

// docs_new/index.mdx
<PopularModels models={popularModels} variant="hero" />
// docs_new/cookbook/intro.mdx
<PopularModels models={popularModels} />
  • docs_new/src/snippets/configs/popular-models.jsx (new) — the list. Seeded with Kimi-K3, Inkling, GLM-5.2. Tags and blurbs come from each model's own cookbook config and page: platform counts from supportedHardware, precisions from quantizations.
  • docs_new/src/snippets/_popular_models.jsx (new) — the carousel. variant="hero" keeps the existing banner design, one slide per model. variant="strip" (Cookbook) is a compact line: brand mark, name, tags, "Open". The Cookbook column is 472px wide, so a hero there is 526px tall and pushes the guide cards off screen; the strip is 107px.
  • Featuring a different model is now a list edit, not a page edit.

Details worth knowing for review:

  • Rotation pauses on hover/focus, and prefers-reduced-motion readers get no autoplay and no transitions. Hero rotates every 9s, strip every 6s.
  • Dots and prev/next live in the card chrome, never in the slide body — a → inside a slide reads as "next" when clicking it would in fact navigate to the model page.
  • Only the active slide is opaque, so mid-slide you never see two half-drawn cards.
  • Both shapes come from one export: Mintlify evaluates each exported component on its own at hydration, so a module-level helper shared by two components is out of scope at runtime (this fails at render, not at mint validate).
  • The hero blurb is a div, not a p, because MDX rewrites p to its own inline element.

Nav

  • Renames the Kimi group and cookbook card from "Moonshotai" to "Kimi (Moonshot AI)".
  • Leads the Autoregressive Models nav with Kimi (Moonshot AI), Thinking Machines, GLM; the remaining 23 vendor groups keep their relative order. The cookbook card grid mirrors the nav, so it is reordered to match.

Page paths are untouched throughout, so no URLs move.

Checklist

  • mint validate passes
  • Rendered locally (mint dev), all three pages, no console errors
  • Rotation verified: index cycles 0→1→2→0, dots' aria-current tracks it, prev/next work
  • Hero slides are equal height (314px each), so the banner does not jump between slides
  • No horizontal page scroll at 1280px or 375px; at 375px the label and controls wrap instead of overlapping
  • Nav reorder keeps all 26 groups and all 81 pages; sidebar and card grid both lead with Kimi → Thinking Machines → GLM
  • Hover-pause not exercised in a headless browser — worth a click-through on the preview

CI States

Latest PR Test (Base): ✅ Run #30502568100
Latest PR Test (Extra): ❌ Run #30502567917

The docs landing page hard-coded a ~180-line Kimi-K3 hero, and the Cookbook
landing page had no model entrance at all. Both now render one shared list
(docs_new/src/snippets/configs/popular-models.jsx) through one component:

  <PopularModels models={popularModels} variant="hero" />   index.mdx
  <PopularModels models={popularModels} />                  cookbook/intro.mdx

variant="hero" keeps the existing banner design, one slide per model. The
Cookbook strip is the compact form — brand mark, name, tags, "Open" — since
that page's content column is 472px and prose would push the guide cards off
screen. Featuring a different model is now a list edit, not a page edit.

Seeded with Kimi-K3, Inkling, and GLM-5.2; tags and blurbs come from each
model's own cookbook config and page (platform counts from supportedHardware,
precisions from quantizations).

Rotation pauses on hover/focus and is skipped under prefers-reduced-motion;
dots and prev/next sit in the card chrome, never in the slide body, so no
glyph inside a slide reads as "next" when it would navigate instead.

Also renames the Kimi nav group and cookbook card from "Moonshotai" to
"Kimi (Moonshot AI)". Page paths are unchanged, so no URLs move.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jul 30, 2026
@mintlify

mintlify Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lmsysorg 🟢 Ready View Preview Jul 30, 2026, 12:11 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

…ines, GLM

Hoist those three vendor groups to the top of the Autoregressive Models nav,
ahead of Qwen; the remaining 23 keep their relative order. The cookbook card
grid mirrors the nav order, so it is reordered the same way.

Group names and page paths are untouched — only the ordering moves, so no URLs
change.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@zijiexia zijiexia changed the title [docs] Rotate popular models on the docs and Cookbook landing pages [docs] Rotate popular models on the landing pages, lead the Cookbook nav with Kimi Jul 30, 2026
@mintlify

mintlify Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lmsysorg 🟡 Building – Jul 30, 2026, 12:09 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@zijiexia
zijiexia merged commit 5efbb18 into main Jul 30, 2026
88 of 92 checks passed
@zijiexia
zijiexia deleted the claude/cookbook-popular-models-carousel branch July 30, 2026 00:46
saturn-acc pushed a commit to saturn-acc/sglang that referenced this pull request Aug 16, 2026
…nav with Kimi (sgl-project#32835)

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
Atituiset pushed a commit to Atituiset/sglang that referenced this pull request Sep 10, 2026
…nav with Kimi (sgl-project#32835)

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>

This branch was successfully deployed

1 active deployment
staging - docs_new — d1a4f8b5 Deployed Jul 30, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants