Restructure How it works: Configure, Control, Scale, Observe, Manage

[andrewleesteele]

Summary

First layer of the guides IA restructure (stack: #671 → #672 → #673 → #674). Adds the How it works section — Configure, Control, Scale, Observe, Manage — each with an overview page, and reorganizes the pages under it so readers see the features that matter before the knobs.

Configure

• New overview covering browser creation, browser types (headful, headless, GPU), viewport, standby, and timeouts. The individual browser setting pages leave the sidebar and are linked from it.
• Stealth, Proxies, Profiles, Vaults, Authentication, Payments, Config Registry.
• Authentication nests the managed auth pages in their own group. Managed Auth Credentials is merged into Configuration (redirected), and the managed auth overview gets a connection options table.
• The hCaptcha beta page folds into Stealth Mode (redirected). Vaults gets a credential-source comparison. Link by Stripe and AgentCard titles fixed.

Control

• Overview leads with the control surface choice (now including WebMCP and the REPL) and where the loop runs. The "why" sections move into the computer controls and Playwright execution pages.
• Sidebar: Playwright Execution, Computer Controls, WebMCP, Browser REPL, Process Execution, File I/O, Code Execution Platform. Curl and SSH are linked from the overview. Browser REPL gets its own tab under where the loop runs.
• Code execution platform: secrets folds into Deploy and stopping into Invoke (both redirected); pages get task titles.

Scale

• Overview leads with limits and performance, then the on-demand versus pool decision with on-demand as the default.
• New Concurrency and Limits page holds every per-plan limit and the API rate limits; links to the old pricing anchors point at it.

Observe — Browser telemetry pages grouped under their own section.

Manage — New overview with a multi-tenant setups section. Network Access is retitled as the firewall allowlist. Projects headings move to sentence case.

Across the section, overview pages get specific titles (for example "Proxies Overview") and headings use sentence case.

Stack notes

Merge the stack in order. Until #673 merges, pages not yet moved stay in their existing sidebar groups, so every layer builds and has no broken links on its own.

Open PRs to reconcile when merging

• Clarify when to use browser pools #641 (browser pool guidance): its Scale overview text is already included here; keep this version of introduction/scale.mdx and reapply its pools/create edits with the new limits anchors.
• docs(auth): add Fill from Managed Auth how-to #622, Document custom WebMCP tools #629, Document browser egress allowlists #657, Document per-host proxy routes #661, Document browser location controls #602: add their new pages to the new groups (Authentication › Managed Auth, Control after WebMCP, Configure overview's settings list, Proxies, Configure overview).
• Update Link payment docs for checkout-bound authorization #630, Document persistent proxies and plan inventory limits #651, Document restricted-destination routing beyond .gov #618: proxy and payments content edits; merge cleanly or rebase on the new page titles.

Testing

• mint validate and mint broken-links pass on this branch.
• Rendered locally to check the Configure, Control, Scale, Observe, and Manage overviews.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation and navigation-only changes with redirects for moved pages; no runtime product code.

Overview
Restructures the Guides sidebar around a new How it works flow: Configure, Control, Scale, Observe, and Manage, each with an overview page and regrouped child docs in docs.json.

Configure adds introduction/configure.mdx as the browser-setup hub; stealth, proxies, profiles, vaults, auth, payments, and config registry sit under it. Managed Auth Credentials (auth/credentials.mdx) is folded into Connection Configuration with redirects; apps/secrets and apps/stop move into Deploy and Invoke (with redirects). hCaptcha content merges into stealth (standalone page removed).

Control rewrites introduction/control.mdx around control surface vs where the agent loop runs; code execution platform pages get clearer titles/descriptions. Scale adds browsers/concurrency-and-limits.mdx and retargets concurrency/rate-limit links from pricing anchors. Observe groups telemetry under a sidebar subsection; Manage adds introduction/manage.mdx and moves projects, API keys, audit logs, and firewall allowlist there.

Cross-cutting: overview titles/sidebarTitle/description front matter, sentence-case headings, eyebrow.js to hide duplicate section eyebrows, seo.indexing, changelog link fixes, and vault credential-source comparison on vaults/overview.mdx.

^{Reviewed by Cursor Bugbot for commit 8bdac1d. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

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

Project	Status	Preview	Updated
Kernel	🟢 Ready	View Preview	Oct 7, 2026, 6:23 PM

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

[cursor]

Stale Bugbot comment from a previous run.

[dprevoznik]

Left some comments!

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 3 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 18ca8c3. Configure here.}

[cursor]

Configure copies region codes

Medium Severity

The new Configure overview inlines the shipped region codes us-east, eu-west, and ap-southeast instead of only linking to the canonical Regional Browsers page.

 

^{Triggered by learned rule: Regional browsers: latency not residency; canonical /browsers/regions}

^{Reviewed by Cursor Bugbot for commit 18ca8c3. Configure here.}

[AnnaXWang]

I really like this - can we double check that old links will automatically redirect to new links?

[andrewleesteele]

Yes, every link that works today will keep working!

[andrewleesteele]

@AnnaXWang yes, checked against the deployed preview for the full stack:

• Pages: every page URL on main and every redirect source (260 URLs) resolves. The two exceptions, /llm.md and /llm-browser.md, already 404 on production today and aren't touched by this stack.
• Removed or merged pages redirect to where their content moved:
  • /apps/secrets → /apps/deploy#secrets
  • /apps/stop → /apps/invoke#stop-an-invocation
  • /auth/credentials → /auth/configuration#credentials-and-auto-reauth
  • /browsers/bot-detection/hcaptcha → /browsers/bot-detection/stealth#hcaptcha-beta
  • /integrations/vercel/foreman → /cookbooks/eve-foreman
• Pages that left the sidebar keep their URLs, including integration, skill, and browser settings pages.
• Section anchors: where a heading was renamed or moved, the old #anchor is kept as a hidden anchor on the new section. For example, /info/pricing#rate-limiting and /introduction/scale#why-a-browser-pool still land on the right section.

One limit: a link into a sub-section of a deleted page lands at the top of the section it redirects to, since a redirect carries a single fragment.

[dprevoznik]

LGTM