Skip to content

add pool sizing calculator to reserved browsers overview#392

Draft
dprevoznik wants to merge 3 commits into
mainfrom
hypeship/pool-sizing-calculator
Draft

add pool sizing calculator to reserved browsers overview#392
dprevoznik wants to merge 3 commits into
mainfrom
hypeship/pool-sizing-calculator

Conversation

@dprevoznik
Copy link
Copy Markdown
Contributor

Summary

  • New interactive calculator at the bottom of browsers/pools/overview.mdx that recommends a reserved pool size from acquisition rate, average acquired duration, and fill rate.
  • Calculator assumes reuse: false on release (every acquisition triggers a refill). It computes both the concurrency floor (Little's Law with a 1.25× safety factor to match the FAQ's 10–20% headroom guidance) and the refill floor (driven by the 25%-per-minute fill ceiling), and returns the larger of the two with a "binding constraint" indicator.
  • Docs section explains the equation, the ~3.2-minute crossover between the two constraints, and a small worked-examples table.

Formula

concurrency_floor = ceil(λ × d × 1.25)
refill_floor      = ceil(100 × λ / fill_rate)
N                 = max(concurrency_floor, refill_floor)

Test plan

  • Mintlify preview renders the calculator inside the overview page
  • Inputs update the recommended size live and flash on change
  • Fill rate clamps to 1–25
  • Worked-examples table values match the calculator output
  • URL query params (acquisitionRate, sessionDuration, fillRate) update on interaction, matching the existing pricing calculator pattern

Adds an interactive calculator under the Browser Pools overview page
that recommends a pool size from acquisition rate, average acquired
duration, and fill rate. Includes the underlying formula (concurrency
floor vs refill floor) and worked examples.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented Jun 2, 2026

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

Project Status Preview Updated (UTC)
Kernel 🟢 Ready View Preview Jun 2, 2026, 3:29 PM

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

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

Risk assessment: Low risk.

Evidence from the diff: this PR modifies browsers/pools/overview.mdx and adds an isolated snippets/pool-sizing-calculator.jsx Mintlify snippet for a docs-page calculator. The change is user-facing documentation UI, but it doesn't modify production runtime code, auth, permissions, billing, infrastructure, shared libraries, or data/schema behavior. I also found no CODEOWNERS file in the repo and no existing approvals on the PR, so approval is appropriate under the requested rules.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

Risk assessment: Low risk.

Evidence from the diff: this PR modifies browsers/pools/overview.mdx and adds snippets/pool-sizing-calculator.jsx, an isolated Mintlify docs-page calculator. The change is user-facing documentation UI, but it doesn't touch production application code, auth, permissions, billing, infrastructure, shared libraries, data/schema behavior, or deployment configuration. The snippet only performs local calculator state updates and URL query/hash replacement in the browser.

I found no CODEOWNERS file in the repo. The PR is already approved on the current head commit, so I did not add another approval.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant