Restructure docs navigation around how it works

[andrewleesteele]

Summary

Replaces the difficulty-tier guides sidebar (Basics / Intermediate / Advanced / Info) with four groups. Pages are ranked by what a reader is doing rather than by how hard they are.

• Overview: Introduction, See all products, Important concepts, Why KERNEL?
• Start building: Quickstart, Cookbooks, Agent Skills, Integrations
• How it works
  • Configure: browser settings, stealth, proxies, profiles, vaults, authentication, payments, config registry
  • Control: overview, playwright execution, computer controls, WebMCP, REPL, Browser Loop, code execution platform, curl, file I/O, process execution, ssh
  • Scale: overview, browser pools, concurrency and limits, performance
  • Observe: overview, live view, replays, telemetry
  • Manage: projects, API keys, audit logs, network access, spending caps
• Partnering with KERNEL: plans and pricing, enterprise, support, community

What changed

• Cookbooks, Agent Skills, and Integrations are one sidebar entry each. Each opens a card grid; the individual pages are reached from their cards instead of being listed in the sidebar. The Cookbooks tab is removed.
• Search indexing: seo.indexing is set to "all" so pages no longer listed in the sidebar stay indexed.
• Introduction: rewritten around what KERNEL provides, why browsers run on unikernels (with a diagram), and the open-source browser image and VM runtime. It routes readers to See all products and Quickstart.
• Integrations: sections follow the pieces of a browser agent: existing agents, agent frameworks, computer use models, browser automation frameworks, credentials and payments, deploy, observability.
• Agent Skills: lists every skill in kernel/skills, with the six most installed highlighted first.
• New pages: See all products, Why KERNEL?, Important concepts (how models, agent frameworks, system prompts, tools, skills, automation frameworks, and browser infrastructure fit together), Quickstart (reuses the existing copy-prompt button), Browser Loop, Concurrency and Limits, Enterprise, Trust Center, and Contact Sales.
• Control page: introduction/control now leads with the two decisions — which control surface, and where the loop runs — ahead of the existing per-surface examples.
• Titles: pages that were all titled "Overview" inside a group now have distinct titles, so the flattened Authentication and Payments groups read clearly.
• Limits: every per-plan limit and the API rate limits now live on Concurrency and Limits (Scale). Pricing links there, and links to the old #concurrency-limits and #rate-limiting anchors were repointed.
• No moves: no page paths changed, so no redirects are needed.
• Security, shared responsibility, and vulnerability reporting are now listed under Enterprise. The legal pages are linked from the Enterprise overview.

Needs confirmation before merge

• Per-plan browser-create rate limits. They're left as a TODO comment on Concurrency and Limits.
• Whether pool acquire is exempt from the create rate. Concurrency and Limits currently says it is.

Not in this PR

• The listed factual fixes: CAPTCHA coverage wording, /apps and /auth bare links, "cost-effective" datacenter proxies, "Free tier" naming, the pool timeout default.
• Folding browsers/faq and auth/faq into their parent pages. They're unlisted for now.
• Logo images for the computer use models and Vercel integration cards. Those currently use the group icon.
• Multi-tenant patterns section on Projects.
• Consolidating the seven code execution platform pages.

Testing

mint validate and mint broken-links pass. Checked the sidebar, the products grid, the integrations grid, and a nested Configure page in a local mint dev preview.

🤖 Generated with Claude Code

[mintlify]

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

Project	Status	Preview	Updated
Kernel	🟢 Ready	View Preview	Sep 28, 2026, 4:52 PM

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

[cursor]

Risk assessment: Medium

Not approving. This is a public docs information-architecture change with a wide reader-facing blast radius, and some of the new operational claims are still unfinished in the diff.

What changed (from the diff, 21 files, +832 / −300):

• docs.json replaces the sidebar (Basics / Intermediate / Advanced / Info) with Overview, Start building, How it works, and Partnering with KERNEL, and removes the Cookbooks tab. Pages such as auth/faq, browsers/faq, info/concepts, and info/unikernels leave the nav. seo.indexing is set to "all", which changes which pages search engines index.
• New pages state plan and product facts readers will rely on: concurrency caps (Developer 5, Hobbyist 10, Start-Up 150), create-rate 429 behavior, default memory, Enterprise HIPAA/BAA and zero data retention, and a SOC 2 Type II trust-center pointer.
• browsers/concurrency-and-limits.mdx still has a source TODO that the per-plan browser-create rate table is not confirmed. That page also states that pool acquire is exempt from the create rate.

Why this is Medium, not Low: there is no application auth, billing, or infrastructure code, so this is not a production-systems change. It is also not a small documentation edit. The navigation config is the primary surface of this repo, the change is cross-file, and correctness of the new limits and compliance copy is not settled in the diff.

Code owner review is not required on main (require_code_owner_review is false). No prior approval from this automation to revoke. The PR is still a draft.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Medium

Not approving. Re-checked the full diff after the latest pushes. Risk is unchanged from the earlier assessment, so there is no approval to revoke.

Current diff: 21 files, +854 / −300, still a draft. Code owner review is not required (require_code_owner_review is false on main).

What the diff actually does:

• docs.json replaces the docs sidebar (Basics / Intermediate / Advanced / Info) and removes the Cookbooks tab. Cookbooks, skills, and most integration pages leave the nav and are reached from card grids instead. seo.indexing is set to "all", which changes which pages search engines index.
• New pages state plan and compliance facts readers will rely on: concurrency caps (Developer 5, Hobbyist 10, Start-Up 150), create-rate 429 behavior, default memory, Enterprise HIPAA/BAA and zero data retention, and a SOC 2 Type II trust-center pointer.
• browsers/concurrency-and-limits.mdx still has a source TODO that the per-plan browser-create rate table is not confirmed, and it states that pool acquire is exempt from the create rate.

Commits since the last assessment (4f4df66, 2639ce6) only restore Wallets, Web Bot Auth, and the Vercel template cards on the integrations grid, and swap the quickstart so the coding-agent path comes first. That does not shrink the navigation blast radius or settle the unfinished limits copy.

Why this stays Medium: there is no application auth, billing, or infrastructure code. It is also not a small documentation edit. The navigation config is the primary surface of this repo, the change is cross-file, and correctness of the new limits and compliance copy is not settled in the diff.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Medium

Not approving. Re-checked the full diff after the latest push (e96a02c). Risk is unchanged, and this automation has no prior approval to revoke.

Current diff: 21 files, +861 / −296. The PR is still a draft. Code owner review is not required (require_code_owner_review is false on main, and there is no CODEOWNERS file).

What the diff actually does:

• docs.json replaces the sidebar (Basics / Intermediate / Advanced / Info) and removes the Cookbooks tab. Cookbooks, skills, and most integration pages leave the nav and are reached from card grids instead. seo.indexing is set to "all", which changes which pages search engines index.
• New pages state plan and compliance facts readers will rely on: concurrency caps (Developer 5, Hobbyist 10, Start-Up 150), create-rate 429 behavior, default memory, Enterprise HIPAA/BAA and zero data retention, and a SOC 2 Type II trust-center pointer.
• browsers/concurrency-and-limits.mdx still has a source TODO that the per-plan browser-create rate table is not confirmed, and it states that pool acquire is exempt from the create rate.

Commit since the last assessment (e96a02c) only expands the introduction with the unikernel architecture, ~30ms P50 starts, and the five-second standby behavior. Those claims already appear elsewhere in the docs (performance, standby, pricing). It does not shrink the navigation blast radius or settle the unfinished limits copy.

Why this stays Medium: there is no application auth, billing, or infrastructure code. It is also not a small documentation edit. The navigation config is the primary surface of this repo, the change is cross-file, and correctness of the new limits and compliance copy is not settled in the diff.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Medium

Not approving. Re-checked the full diff after 183fe9b. Risk is unchanged, and this automation has no prior approval to revoke.

Current diff: 21 files, +881 / −331. The PR is still a draft. Code owner review is not required (require_code_owner_review is false on main, and there is no CODEOWNERS file).

What the diff actually does:

• docs.json replaces the sidebar (Basics / Intermediate / Advanced / Info) with Overview, Start building, How it works, and Partnering with KERNEL, and removes the Cookbooks tab. Pages such as auth/faq, browsers/faq, info/concepts, and info/unikernels leave the nav. seo.indexing is set to "all", which changes which pages search engines index.
• New pages state plan and compliance facts readers will rely on: concurrency caps (Developer 5, Hobbyist 10, Start-Up 150), create-rate 429 behavior, default memory (8 GB headful / 1 GB headless), Enterprise HIPAA/BAA and zero data retention, and a SOC 2 Type II trust-center pointer.
• browsers/concurrency-and-limits.mdx still has a source TODO that the per-plan browser-create rate table is not confirmed, and it states that pool acquire is exempt from the create rate.

Commit since the last assessment (183fe9b) only rewrites index.mdx: new lede, unikernel explanation, open-source cards, lowercased section titles, removal of the homepage copy-prompt box, and a plans/enterprise card row. It does not shrink the navigation blast radius or settle the unfinished limits copy.

Why this stays Medium: there is no application auth, billing, or infrastructure code. It is also not a small documentation edit. The navigation config is the primary surface of this repo, the change is cross-file, and correctness of the new limits and compliance copy is not settled in the diff.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Medium

Not approving. Re-checked the full diff at 1e815ae. Risk is unchanged from the earlier assessment, and this automation has no prior approval to revoke.

Current diff: 26 files, +1015 / −339. The PR is still a draft. Code owner review is not required (require_code_owner_review is false on the main ruleset). The decision is based on blast radius, not ownership.

What the diff actually changes:

• docs.json rewrites the published docs navigation: Overview, Start building, and How it works replace the previous groups; the Cookbooks tab is removed; integrations, skills, and info pages are collapsed or relocated. That is the primary reader-facing surface of this repo.
• A new site-wide seo.indexing: "all" setting is added. The redirects list is unchanged, including /quickstart → /, while the new quickstart is /start/quickstart.
• New and rewritten pages (index.mdx, start/quickstart.mdx, overview/*, info/enterprise.mdx, browsers/concurrency-and-limits.mdx, and others) publish operational and commercial claims: plan concurrency numbers, HIPAA/BAA, zero data retention, isolation, and start-up latency.
• browsers/concurrency-and-limits.mdx still contains an explicit TODO that the per-plan create-rate table is not confirmed.

This is larger than a documentation typo or copy edit. It is a cross-file information-architecture change to the public docs site, with unfinished limit numbers and an entry-path redirect that does not follow the new quickstart. There is no application, auth, or infrastructure code, so this stays Medium rather than higher.

No reviewers assigned.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Medium

Not approving. Re-checked the full diff at 937b374. Risk is unchanged from the earlier assessment, and this automation has no prior approval to revoke.

Current diff: 34 files, +1064 / −384. The PR is still a draft. Code owner review is not required (require_code_owner_review is false on the main ruleset, and there is no CODEOWNERS file). The decision is based on blast radius, not ownership.

What the diff actually changes:

• docs.json rewrites the published docs navigation (Overview, Start building, How it works, Partnering with KERNEL), removes the Cookbooks tab, and adds site-wide seo.indexing: "all". Redirects are unchanged. That navigation file is the primary reader-facing surface of this repo.
• New and rewritten pages publish operational and commercial claims readers will rely on: plan concurrency and app-invocation caps, managed-auth health-check intervals, HIPAA/BAA, zero data retention, and ~30ms P50 browser starts.
• browsers/concurrency-and-limits.mdx still contains an explicit TODO that the per-plan browser-create rate table is not confirmed, and it states that pool acquire is exempt from the create rate.

Commit since the last assessment (937b374) moves the plan limit tables and rate-limit header docs off Pricing onto Concurrency and Limits, reorders two Overview nav entries, and rewrites the introduction’s lifecycle and isolation wording. It does not shrink the navigation blast radius or settle the unconfirmed create-rate numbers.

This is larger than a documentation typo or copy edit. It is a cross-file information-architecture change to the public docs site, with unfinished limit numbers. There is no application, auth, billing, or infrastructure code, so this stays Medium rather than higher.

No reviewers assigned.

  

_{Sent by Cursor Automation: Assign PR reviewers}