Merge remote-tracking branch 'origin/tembo/create-sdk-docs-for-proxies-feature-configure-proxy-page' into tembo/create-sdk-docs-for-proxies-feature-configure-proxy-page

Author: sjmiller609

browsers/proxies.mdx

@@ -2,9 +2,9 @@
 title: "Stealth Mode"
 ---
 
-Kernel browsers can be configured to `stealth` mode, which adds a high performant residential proxy and auto-CAPTCHA solver to your instances.
+Kernel browsers can be configured to `stealth` mode, which adds our recommended proxy configuration to your browser instances. It also adds a `reCAPTCHA solver` to the browser, so it automatically solves [reCAPTCHAs](https://www.google.com/recaptcha/api2/demo) on your behalf.
 
-To turn on stealth mode, set its flag in your app code when instantiating Kernel:
+To turn on stealth mode, set its flag when instantiating Kernel browsers:
 
 <CodeGroup>
 ```typescript Typescript/Javascript
@@ -23,4 +23,6 @@ kernel_browser = client.browsers.create(invocation_id=ctx.invocation_id, stealth
     [Anthropic Computer Use](/quickstart#sample-apps-reference) stops when it runs into a CAPTCHA. Use Kernel's auto-captcha solver by adding this to your prompt:
 
     `"If you see a CAPTCHA or similar test, just wait for it to get solved automatically by the browser."`
-</Info>
+</Info>
+
+If you're looking for proxy-level configuration with Kernel browsers, see [Proxies](/proxies/overview).

browsers/stealth.mdx

@@ -56,26 +56,30 @@
             "pages": [
               "browsers/create-a-browser",
               "browsers/headless",
-              "browsers/stealth",
               "browsers/standby",
               "browsers/persistence",
               "browsers/profiles",
-              "browsers/proxies",
               "browsers/termination",
               "browsers/file-io",
               "browsers/live-view",
-              "browsers/replays"
-            ]
-          },
-          {
-            "group": "Proxies",
-            "pages": [
-              "proxies/overview",
-              "proxies/datacenter",
-              "proxies/isp",
-              "proxies/residential",
-              "proxies/mobile",
-              "proxies/custom"
+              "browsers/replays",
+              {
+                "group": "Bot Anti-Detection",
+                "pages": [
+                  "browsers/stealth",
+                  {
+                    "group": "Proxies",
+                    "pages": [
+                      "proxies/overview",
+                      "proxies/custom",
+                      "proxies/mobile",
+                      "proxies/residential",
+                      "proxies/isp",
+                      "proxies/datacenter"
+                    ]
+                  }
+                ]
+              }
             ]
           },
           {

docs.json

@@ -6,9 +6,9 @@ Custom proxies allow you to use your own proxy servers with Kernel browsers. Thi
 
 ## Configuration
 
-<Note>
+<Tip>
 Currently, only HTTPS proxies are supported for custom proxy configurations.
-</Note>
+</Tip>
 
 Specify the host, port, and optional authentication credentials for your proxy server:
 
@@ -63,6 +63,6 @@ browser = client.browsers.create(
 - **`username`** - Username for proxy authentication
 - **`password`** - Password for proxy authentication (minimum 5 characters)
 
-<Note>
+<Info>
 When creating a proxy with authentication, provide the password. The API response will only indicate if a password exists (`has_password: true`) but won't return the actual password for security reasons.
-</Note>
+</Info>

proxies/custom.mdx

@@ -2,7 +2,7 @@
 title: "ISP Proxies"
 ---
 
-ISP proxies use residential IP addresses hosted on high-speed servers, purchased or leased from Internet Service Providers for commercial use. Target sites classify them as residential IPs, allowing you to access websites like a real user while maintaining the speed and reliability of datacenter infrastructure. They're ideal when datacenter proxies are blocked but you still need fast, cost-effective proxies.
+ISP (Internet Service Provider) proxies combine the speed of datacenter proxies with better legitimacy, as they use IP addresses assigned by real ISPs.
 
 ## Configuration
 

proxies/isp.mdx

@@ -55,15 +55,15 @@ browser = client.browsers.create(
 ## Configuration Parameters
 
 - **`country`** - ISO 3166 country code
-- **`carrier`** - Mobile carrier name (e.g., `verizon`, `att`, `tmobile`)
+- **`carrier`** - Mobile carrier name (see available carriers below)
 - **`state`** - Two-letter state code. Only supported for US and Australia. Cannot be used with `city`
 - **`city`** - City name (lowercase, no spaces, e.g., `newyork`, `losangeles`). Required if `zip` is provided
 - **`zip`** - US ZIP code (5 digits). Requires `city` to be provided
 - **`asn`** - Autonomous System Number. Mutually exclusive with geo-location targeting
 
 ## Supported Carriers
 
-Major carriers worldwide are supported, including:
+Major carriers worldwide are supported:
 
 **US Carriers:**
 - `att` - AT&T

proxies/mobile.mdx

@@ -1,32 +1,26 @@
 ---
-title: "Proxies Overview"
+title: "Overview"
 ---
 
 import CreateProxySnippet from '/snippets/openapi/post-proxies.mdx';
 import ListProxiesSnippet from '/snippets/openapi/get-proxies.mdx';
 import DeleteProxySnippet from '/snippets/openapi/delete-proxies-id.mdx';
 
-Kernel proxies enable you to route browser traffic through different types of proxy servers, providing enhanced privacy, geographic flexibility, and bot detection avoidance. Proxies can be created once and reused across multiple browser sessions.
+Kernel proxies enable you to route browser traffic through different types of proxy servers, providing enhanced privacy, flexibility, and bot detection avoidance. Proxies can be created once and reused across multiple browser sessions.
 
 ## Proxy Types
 
-Kernel supports five types of proxies, ranked by quality for avoiding bot detection (from best to worst):
+Kernel supports five types of proxies, ranked by quality (from best to worst):
 
-1. **Mobile** - Traffic routed through mobile carrier networks
-2. **Residential** - Traffic routed through residential ISP connections
-3. **ISP** - Traffic routed through ISP data centers
-4. **Datacenter** - Traffic routed through commercial data centers
-5. **Custom** - Your own proxy servers
+0. [**Custom**](/proxies/custom) - Your own proxy servers
+1. [**Mobile**](/proxies/mobile) - Traffic routed through mobile carrier networks
+2. [**Residential**](/proxies/residential) - Traffic routed through residential ISP connections
+3. [**ISP**](/proxies/isp) - Traffic routed through ISP data centers
+4. [**Datacenter**](/proxies/datacenter) - Traffic routed through commercial data centers
 
 ## 1. Create a proxy
 
-<Info>
-First, install the Kernel SDK:
-- Typescript/Javascript: `npm install @onkernel/sdk`
-- Python: `pip install kernel`
-</Info>
-
-Create a proxy configuration that can be reused across browser sessions:
+Create a proxy configuration from the types above that can be reused across browser sessions:
 
 <CreateProxySnippet />
 
@@ -88,6 +82,6 @@ When no longer needed, delete the proxy configuration:
 
 <DeleteProxySnippet />
 
-<Note>
-Deleting a proxy does not affect existing browser sessions that are using it. The proxy configuration is only removed from your organization.
-</Note>
+<Info>
+Deleting a proxy does not affect existing browser sessions that are currently using it. The configuration is only removed from your organization so it can't be used in future browser sessions.
+</Info>

proxies/overview.mdx

@@ -2,7 +2,7 @@
 title: "Residential Proxies"
 ---
 
-Residential proxies use real IPs from people who opt-in and are rewarded for lending their IP to the network. This allows you to target sophisticated, hard-to-reach websites with local IPs from the target area, helping you browse or collect data as a real person would. They're ideal when datacenter or ISP proxies result in low success rates or get blocked.
+Residential proxies route traffic through real residential IP addresses. They support advanced targeting options including city, state, and operating system.
 
 ## Configuration