Move scaling guide to Introduction as "Scale"

browsers/pools/overview.mdx

@@ -1,9 +1,11 @@
 ---
 title: "Overview"
-description: "Pre-configure pools of reserved browsers for immediate acquisition"
+description: "Pre-configure pools of reserved browsers"
 ---
 
-Browser pools let you maintain a set of reserved, identical browsers ready for immediate use. Use them to set your preferred browser configuration in advance, allowing you to minimize browser start-up latency and scale your workloads in production.
+Browser pools let you maintain a set of reserved, identical browsers ready for immediate use. Use them to set your preferred browser configuration in advance (such as stealth, proxies, extensions, and profiles), allowing you to minimize browser start-up latency and scale your workloads in production. 
+
+Acquiring a browser from a pool is faster than creating a browser directly. Reserved browsers and on-demand browsers share the same concurrency limit, and reserved browsers aren't billed until they're used. See [Scale](/introduction/scale) for how pools fit into best practices for production architecture.
 
 ## How browser pools work
 
@@ -27,7 +29,7 @@ Browser pools are a way to pre-configure a fixed set of browsers without being c
     </Info>
   </Step>
   <Step title="Release a browser">
-    When you're done with a browser, release it back to the pool. this step is important; otherwise, the browser will continue to be in an `acquired` state until it times out.
+    When you're done with a browser, release it back to the pool. This step is important; otherwise, the browser will continue to be in an `acquired` state until it times out.
 
     <Info>
     Failing to release browsers may result in unexpected latency when acquiring future browsers.

changelog.mdx

@@ -369,7 +369,7 @@ For API library updates, see the [Node SDK](https://github.com/onkernel/kernel-n
 - We released [skills](https://skills.sh/?q=kernel/skills) for Kernel, so you can easily build browser agents directly from Claude Code.
 
 ## Documentation updates
-- We published a [Scaling in Production guide](/browsers/pools/scaling) with recommendations and best practices for handling high-concurrency workloads. Read it to learn how and when to use browser pools versus on-demand browsers, and see code samples for production implementations.
+- We published a [Scaling in Production guide](/introduction/scale) with recommendations and best practices for handling high-concurrency workloads. Read it to learn how and when to use browser pools versus on-demand browsers, and see code samples for production implementations.
 - Added a new [integration guide](https://www.kernel.sh/docs/integrations/agent-browser) for [Agent Browser](https://github.com/vercel-labs/agent-browser), Vercel's headless browser automation CLI, which has built-in support for Kernel browsers.
 </Update>
 

docs.json

@@ -13,6 +13,7 @@
     { "source": "/browsers/hardware-acceleration", "destination": "/browsers/gpu-acceleration" },
     { "source": "/integrations/computer-use", "destination": "/integrations/computer-use/overview" },
     { "source": "/browsers/create-a-browser", "destination": "/introduction/create" },
+    { "source": "/browsers/pools/scaling", "destination": "/introduction/scale" },
     { "source": "/introduction", "destination": "/" },
     { "source": "/quickstart", "destination": "/" },
     { "source": "/home", "destination": "/" },
@@ -73,7 +74,8 @@
               "index",
               "introduction/create",
               "introduction/control",
-              "introduction/observe"
+              "introduction/observe",
+              "introduction/scale"
             ]
           },
           {
@@ -162,7 +164,6 @@
                     "pages": [
                       "browsers/pools/overview",
                       "browsers/pools/policy-json",
-                      "browsers/pools/scaling",
                       "browsers/pools/faq"
                     ]
                   }

browsers/pools/scaling.mdx → introduction/scale.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Scaling in Production"
-description: "Recommended practices for scaling"
+title: "Scale"
+description: "Recommended practices for scaling in production"
 ---
 ## Introduction
 

style.css

@@ -247,4 +247,4 @@ html.dark .callout[class*="yellow"] svg {
 
 .dark .card:hover {
   border-color: rgb(223 223 223) !important;
-}
+}