Skip to content

[feat]: collapse cookbook recipe pages into an accordion layout, add … - #1805

Merged
SolitaryThinker merged 3 commits into
hao-ai-lab:mainfrom
Ishxn20:ui/cookbook-recipe-builder
Sep 1, 2026
Merged

[feat]: collapse cookbook recipe pages into an accordion layout, add …#1805
SolitaryThinker merged 3 commits into
hao-ai-lab:mainfrom
Ishxn20:ui/cookbook-recipe-builder

Conversation

@Ishxn20

@Ishxn20 Ishxn20 commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

This PR restructures the cookbook recipe pages to reduce excessive scrolling and adds new configuration options to the MiniMax H3 recipe builder.

Layout changes (all 15 cookbook family pages)

The Setup, Troubleshooting, and Evidence Status sections are converted from static, always-expanded prose into collapsible sections, with a jump-navigation bar added beneath the page header for direct access to each section. This is applied consistently across all cookbook family pages to keep the shell uniform.

New configuration options (MiniMax H3 only)

The recipe builder now exposes two additional controls where the underlying scripts support them:

  • GPU count (--num-gpus), available on all CUDA recipes in the family
  • VAE decode backend (--video-decode-backend, full quality vs. TAEH3 preview), available on the FastH3-related recipes

The generated command updates live to reflect the selected values. Selecting a non-default value surfaces an explicit note that the configuration has not been benchmarked, consistent with the page's existing evidence-tracking conventions.

Other

Removed an outdated "Inference first, then the full workflow" roadmap notice from the cookbook index page.

Testing

  • Extended docs/generate_examples.py's cookbook validator to enforce the new knob schema, including verifying that each knob's flag is present in its associated source script (directly or via an inherited argument parser).
  • Built the full documentation site locally and verified in-browser that sections expand/collapse correctly, jump-navigation links resolve to the correct anchors, and knob selections correctly update the displayed command, caveat notes, and URL query parameters across recipe and runtime switches.
  • Ran python3 docs/generate_examples.py to confirm all cookbook data and generated documentation pass existing validation.

Copilot AI lite review requested due to automatic review settings September 1, 2026 08:13

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@mergify mergify Bot added type: feat New feature or capability scope: docs Documentation labels Sep 1, 2026
@mergify

mergify Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Merge Protections

🔴 1 of 1 protections blocking · waiting on 👀 reviews and 🤖 CI

Protection Waiting on
🔴 PR merge requirements 👀 reviews and 🤖 CI

🔴 PR merge requirements

Waiting for

  • #approved-reviews-by>=1
  • check-success=fastcheck-passed
  • check-success=full-suite-passed
This rule is failing.
  • #approved-reviews-by>=1
  • check-success=fastcheck-passed
  • check-success=full-suite-passed
  • check-success~=pre-commit
  • title~=(?i)^\[(feat|feature|bugfix|fix|refactor|perf|ci|doc|docs|misc|chore|kernel|new.?model|skill|skills|infra)\]

@mergify

mergify Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Pre-commit checks failed

Hi @Ishxn20, the pre-commit checks have failed. To fix them locally:

# Install pre-commit if you haven't already
uv pip install pre-commit
pre-commit install

# Run all checks and auto-fix what's possible
pre-commit run --all-files

Common fixes:

  • yapf: yapf -i <file> (formatting)
  • ruff: ruff check --fix <file> (linting)
  • codespell: codespell --write-changes <file> (spelling)

After fixing, commit and push the changes. The checks will re-run automatically.

For future commits, pre-commit will run automatically on changed files before each commit.

Vaish, Ishan and others added 3 commits September 1, 2026 01:42
@Ishxn20
Ishxn20 force-pushed the ui/cookbook-recipe-builder branch from 6429364 to 6c6fff9 Compare September 1, 2026 08:48
@SolitaryThinker
SolitaryThinker merged commit 3d8ac9d into hao-ai-lab:main Sep 1, 2026
3 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

scope: docs Documentation type: feat New feature or capability

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants