docs: document residential proxy IP rotation behavior

[ulziibay-kernel]

Summary

• Adds a prominent warning to the residential proxies page explaining that exit IPs rotate per connection
• Adds an "IP Rotation Behavior" section with practical details (same-site tabs share IPs via connection pooling, different-site tabs get different IPs, reconnections may rotate)
• Adds a residential vs ISP comparison table to help users pick the right proxy type
• Adds an Info callout to the proxies overview page linking to the new section

Context

A customer reported seeing different IP addresses across browser tabs when using a residential proxy. Investigation confirmed this is expected behavior — residential proxies use rotating sessions by default (per Byteful/PingProxy docs). Our docs didn't mention this at all, leading to confusion.

Test plan

• Verify Mintlify preview renders the Warning, Info, and table correctly
• Confirm internal links to /proxies/isp and /proxies/residential#ip-rotation-behavior resolve

Made with Cursor

---

Note

Low Risk
Low risk docs-only changes; the main risk is minor confusion from incorrect wording or broken internal anchors/links.

Overview
Adds an Info callout on proxies/overview.mdx clarifying that datacenter/ISP proxies have stable exit IPs while residential proxies rotate IPs per connection, with a deep link to the relevant section.

Expands proxies/residential.mdx with a prominent Info warning and a new IP Rotation Behavior section explaining per-TCP-connection rotation and common tab/reconnection scenarios, plus guidance to use ISP proxies when a consistent IP is required.

^{Reviewed by Cursor Bugbot for commit 37108ff. 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 (UTC)
Kernel	🟢 Ready	View Preview	Apr 27, 2026, 3:22 PM

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

[firetiger-agent]

Firetiger deploy monitoring skipped

This PR didn't match the auto-monitor filter configured on your GitHub connection:

Any PR that changes the kernel API. Monitor changes to API endpoints (packages/api/cmd/api/) and Temporal workflows (packages/api/lib/temporal) in the kernel repo

Reason: PR only modifies documentation for residential proxy behavior; no changes to API endpoints or Temporal workflows.

To monitor this PR anyway, reply with @firetiger monitor this.

[cursor]

Stale comment

Risk assessment: Very Low.

I re-evaluated the current diff for commit 222e896. The changes only add explanatory documentation to proxies/overview.mdx and proxies/residential.mdx about residential proxy exit IP rotation. There are no code, config, navigation, prompt, infrastructure, API, or operational changes, and I found no CODEOWNERS file requiring a codeowner review.

The PR is already approved, so I’m not submitting another approval. The updated diff does not increase risk.

  

_{Sent by Cursor Automation: Assign PR reviewers}

[cursor]

Risk assessment: Very Low.

I reviewed the current diff for commit 37108ff. The PR only adds explanatory documentation to proxies/overview.mdx and proxies/residential.mdx about residential proxy exit IP rotation. There are no code, config, navigation, prompt, infrastructure, API, or operational changes, and I found no CODEOWNERS file requiring codeowner review.

The PR is already approved, so I’m not submitting another approval. The synchronized update does not increase risk.

  

_{Sent by Cursor Automation: Assign PR reviewers}