docs: Navbar improvement

[aabedraba]

• Merge Guides and Tutorials
• Put references in a single tab

[aabedraba]

needed so that zudoku v88 doesn't add counters to the table of content for the steps

[aabedraba]

needed for the react component of the Navbar

[aabedraba]

updated because bug in v86

[Copilot]

Copilot review overview

🔵 Needs a closer look

Active navigation matching does not account for the production /docs base path.

Review effort: Lite
Findings: None

What changed in this PR

Improves the documentation navbar by grouping guides and consolidating reference links.

Changes:

• Groups Tutorials and Example apps under Guides.
• Adds a Reference dropdown for CLI, Kraftfile, and Platform API.
• Updates guide generation, documentation, and Zudoku dependencies.

File	Summary
zudoku.config.tsx	Restructures navigation and adds Reference links.
src/​TopNavMenus.tsx	Implements grouped menus; active-route matching needs to account for /docs base path.
scripts/​update_zudoku_guides.py	Updates generated example-app entries.
pnpm-lock.yaml	Refreshes dependency resolution.
pages/​introduction.mdx	Adjusts Stepper table-of-contents behavior.
pages/​guides/​overview.mdx	Documents tutorial and example-app groupings.
package.json	Upgrades Zudoku and adds React typings.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[nderjung]

For me, i'd like to keep "CLI Reference" visible at the top-level without hiding it, same with "Platform API" -> less clicks / more visible. I think we can shorten them though:

• "CLI Reference" -> "CLI"
• "Platform API" -> "APIs"

Having an "Integrations" dropdown does make sense though, with "Kubernetes", "Docker", "Terraform", etc. can be placed there.

"Kraftfile" needs a bit of thought where we should put that.

Also agree to merge Guides/Tutorials -> it's the same thing really.

[aabedraba]

@nderjung

I really think it's a cluttered top navbar. All top docs don't have that many things there: Mintlify, Vercel, Zuplo, WorkOS.

I personally never look at that top navbar, when I have a sidebar, only for API references and whatnot.

I addressed your changes here, we can think about it later:

[nderjung]

Thanks!

Reviewed-by: Alexander Jung alex@unikraft.com
Approved-by: Alexander Jung alex@unikraft.com