Move scaling guide to Introduction as "Scale"

[AnnaXWang]

Summary

• Moves browsers/pools/scaling.mdx to introduction/scale.mdx so the scaling guide lives in the Overview section alongside Create, Control, and Observe. Page is retitled to Scale.
• Adds a redirect in docs.json so /browsers/pools/scaling routes to /introduction/scale.
• Updates navigation: introduction/scale added to the Overview group, removed from the Reserved Browsers group.
• Adds a Why reserve browsers with browser pools section to the pools overview (above "How browser pools work") covering the concrete benefits — setup out of the critical path, no billing until acquired, uniform configuration, predictable capacity — with a backlink to /introduction/scale for production best practices.
• Updates the changelog's link to the guide's new path and fixes a lowercase sentence start in the pools overview.

Testing

Validated docs.json parses as valid JSON and grepped for remaining /browsers/pools/scaling references (only the new redirect remains). Did not run mintlify dev locally.

Preview: https://tbd-6fc993ce-hypeship-move-scaling-to-intro-scale.mintlify.app/introduction/scale

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation and navigation-only changes with a redirect; no product or API behavior changes.

Overview
Relocates the production scaling guide from Reserved Browsers to the Overview intro track as /introduction/scale, retitled Scale, so it sits alongside Create, Control, and Observe.

docs.json adds a redirect from /browsers/pools/scaling to the new path, lists introduction/scale under Overview, and removes browsers/pools/scaling from the pools nav group.

browsers/pools/overview.mdx refreshes the page framing (shorter description, examples of pre-configured settings, faster pool acquire vs on-demand create, shared concurrency and billing-until-acquired) and links readers to the Scale guide for production architecture. Fixes capitalization in the release step (“This step is important”).

changelog.mdx updates the January 30 docs bullet to point at /introduction/scale.

style.css adds a trailing newline only.

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

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

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

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

[cursor]

Scale page uses CDP examples

Medium Severity

This PR moves the scaling guide to introduction/scale and lists it under Overview with Create, Control, and Observe, but the architecture accordions still drive browsers only via chromium.connectOverCDP. For intro/overview pages, docs should treat the Playwright Execution API as the default Playwright pattern, like introduction/create and introduction/control.

 

^{Triggered by learned rule: Promote Playwright Execution API over direct CDP connections in examples}

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

[mintlify]

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

Project	Status	Preview	Updated (UTC)
Kernel	🟢 Ready	View Preview	Jul 9, 2026, 10:21 PM

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

[cursor]

Risk assessment: Very Low.

Evidence from the diff:

• The change set is documentation-only: browsers/pools/scaling.mdx is moved to introduction/scale.mdx with only title/description frontmatter changes to the moved page.
• docs.json updates Mintlify navigation and adds a redirect from /browsers/pools/scaling to /introduction/scale.
• The remaining edits are a changelog link update, a short browser-pools overview paragraph, and a capitalization fix.
• No application/runtime code, auth or permissions logic, infrastructure, data migrations, shared libraries, or production logic changed.

I found no CODEOWNERS file in the repository. The PR is already approved on the current head commit, so I’m not re-approving it.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Very Low.

Evidence from the current diff:

• browsers/pools/scaling.mdx is renamed to introduction/scale.mdx with only frontmatter title/description edits; the guide content is otherwise unchanged.
• docs.json updates Mintlify navigation and adds a redirect from /browsers/pools/scaling to /introduction/scale.
• The remaining edits are documentation/link copy in browsers/pools/overview.mdx and changelog.mdx, plus a trailing-newline fix in style.css.
• No runtime code, auth/permissions logic, infrastructure, data migrations, shared libraries, or production logic changed.

I found no CODEOWNERS file in the repository. GitHub currently reports the PR as already approved, so I’m leaving this risk assessment as a comment rather than adding another approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[juecd]

I left a comment about the paragraph but approving so you can merge without another review

[juecd]

I think it's unusual to see long paragraphs like this in doc guides (I cross referenced this intuition with https://modal.com/docs/guide). I would break out each sentence into a bullet.

This sentence doesn't feel specific enough:

Browser pools move browser setup out of your critical path: browsers with your full configuration—stealth, proxies, extensions, profiles—are provisioned ahead of time, so acquiring one returns a ready browser instead of paying setup cost on every task.

Suggestion:

Browser pools move browser setup out of your critical path. It allows you to provision browsers with your specific configuration ahead of time (such as stealth, proxies, extensions, and profiles), rather than the setup latency happening at agent runtime. Acquiring one returns a configured browser in milliseconds.

[AnnaXWang]

thank you!

[cursor]

Risk assessment: Very Low.

Evidence from the current diff:

• browsers/pools/scaling.mdx is moved to introduction/scale.mdx; the moved page keeps the same guide content with only frontmatter title/description changes.
• docs.json updates the Mintlify sidebar placement and adds a redirect from /browsers/pools/scaling to /introduction/scale.
• The other changes are limited to docs copy/link updates in browsers/pools/overview.mdx and changelog.mdx, plus a newline-only fix in style.css.
• No runtime code, auth/permissions logic, infrastructure, data migrations, shared libraries, or production logic changed.

I found no CODEOWNERS file in the repository. GitHub currently reports the PR as already approved, so I’m leaving this assessment as a comment rather than adding another approval. The risk level has not increased, so I’m not dismissing the existing approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Very Low.

Evidence from the actual diff:

• browsers/pools/scaling.mdx is renamed to introduction/scale.mdx with 98% similarity; the moved guide only changes its frontmatter title/description.
• docs.json updates the Mintlify sidebar and adds a redirect from /browsers/pools/scaling to /introduction/scale.
• The remaining edits are docs-only: a short browser-pools overview paragraph, a changelog link update, a capitalization fix, and a trailing-newline fix in style.css.
• No runtime application code, auth/permissions logic, infrastructure, data migrations, shared libraries, or production behavior changed.

I found no CODEOWNERS file in the repository. GitHub already reports this PR as approved, so I’m leaving this risk assessment as a comment rather than adding another approval. The risk level has not increased, so there’s no reason to dismiss an existing approval.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Very Low.

Evidence from the actual diff:

• The PR changes only docs/navigation assets: browsers/pools/overview.mdx, changelog.mdx, docs.json, a rename from browsers/pools/scaling.mdx to introduction/scale.mdx, and a final-newline touch in style.css.
• The renamed scaling guide is 98% similar to the original and only changes its frontmatter title/description.
• docs.json moves the page into the Introduction sidebar and adds a redirect from /browsers/pools/scaling to /introduction/scale.
• No runtime code, auth/permissions logic, infrastructure, data migrations, shared libraries, or production application behavior changed.

I found no CODEOWNERS file in the repository. GitHub already reports this PR as approved, so I’m leaving this risk assessment as a comment rather than adding another approval. The latest synchronize event doesn’t increase the risk, so I’m not dismissing the existing approval.

Note: git diff --check flags one trailing space in browsers/pools/overview.mdx, but that doesn’t affect the risk classification.

  

_{Sent by Cursor Automation: Assign PR reviewers}