reorganize BR overview page to be more focused on what you can do with BR instead of integration methods

kathayl · kathayl · commit a7cc2b2d75a2 · 2025-10-30T16:45:27.000-07:00
diff --git a/src/content/docs/browser-rendering/index.mdx b/src/content/docs/browser-rendering/index.mdx
@@ -19,13 +19,33 @@ import {
 
 <Description>
 
-Browser automation for [Cloudflare Workers](/workers/) and [quick browser actions](/browser-rendering/rest-api/).
+Run headless Chrome on [Cloudflare's global network](/workers/) for browser automation, web scraping, testing, and content generation.
 
 </Description>
 
 <Plan type="workers-all" />
 
-Browser Rendering enables developers to programmatically control and interact with headless browser instances running on Cloudflare’s global network. This facilitates tasks such as automating browser interactions, capturing screenshots, generating PDFs, and extracting data from web pages.
+Browser Rendering enables developers to programmatically control and interact with headless browser instances running on Cloudflare’s global network. 
+
+## Use Cases
+
+Browser Rendering supports a wide range of use cases, including:
+- Extract rendered HTML or convert webpages to Markdown using the [content endpoint](/browser-rendering/rest-api/content-endpoint/) and [markdown endpoint](/browser-rendering/rest-api/markdown-endpoint/)
+- Create website thumbnails and social previews using the [screenshot endpoint](/browser-rendering/rest-api/screenshot-endpoint/)
+- Generate PDFs from webpages and HTML content using the [pdf endpoint](/browser-rendering/rest-api/pdf-endpoint/)
+- Archive complete webpage states with the [snapshot endpoint](/browser-rendering/rest-api/snapshot/) that captures both HTML and screenshots
+- Build web scrapers that target specific elements or extract all links using the [scrape endpoint](/browser-rendering/rest-api/scrape-endpoint/) and [links endpoint](/browser-rendering/rest-api/links-endpoint/)
+- Parse and structure webpage data into JSON format using the [json endpoint](/browser-rendering/rest-api/json-endpoint/)
+
+Browser Rendering is also ideal for agentic workflows. Use [Puppeteer](/browser-rendering/platform/puppeteer/), [Playwright](/browser-rendering/platform/playwright/), [Playwright MCP](/browser-rendering/platform/playwright-mcp/), or [Stagehand](/browser-rendering/platform/stagehand/) to power AI agents that interact with web pages and extract data where APIs do not exist.
+
+## Key features
+
+- **Scale to thousands of browsers**: Instant access to a global pool of browsers with low cold-start time, ideal for high-volume screenshot generation, data extraction, or automation at scale
+- **Global by default**: Browser sessions run on Cloudflare's edge network, opening close to your users for better speed and availability worldwide
+- **Easy to integrate**: [REST APIs](/browser-rendering/rest-api/) for common actions, while [Puppeteer](/browser-rendering/platform/puppeteer/) and [Playwright](/browser-rendering/platform/playwright/) provide familiar automation libraries for complex workflows
+- **Session management**: [Reuse browser sessions](/browser-rendering/workers-bindings/reuse-sessions/) across requests to improve performance and reduce cold-start overhead
+- **Flexible pricing**: Pay only for browser time used with generous free tier ([view pricing](/browser-rendering/platform/pricing/))
 
 ## Integration Methods
 
@@ -36,19 +56,6 @@ You can integrate Browser Rendering into your applications using one of the foll
 
 Choose the method that best fits your use case. For example, use the [REST API endpoints](/browser-rendering/rest-api/) for straightforward tasks from external applications and use [Workers Bindings](/browser-rendering/workers-bindings/) for complex automation within the Cloudflare ecosystem.
 
-## Use Cases
-
-Browser Rendering can be utilized for various purposes, including:
-
-- Fetch HTML content of a page.
-- Capture screenshot of a webpage.
-- Convert a webpage into a PDF document.
-- Take a webpage snapshot.
-- Scrape specified HTML elements from a webpage.
-- Retrieve data in a structured format.
-- Extract Markdown content from a webpage.
-- Gather all hyperlinks found on a webpage.
-
 ## Related products
 
 <RelatedProduct header="Workers" href="/workers/" product="workers">
@@ -59,13 +66,13 @@ Build serverless applications and deploy instantly across the globe for exceptio
 
 <RelatedProduct header="Durable Objects" href="/durable-objects/" product="durable-objects">
 
-A globally distributed coordination API with strongly consistent storage.
+A globally distributed coordination API with strongly consistent storage. Using Durable Objects to [persist browser sessions](/browser-rendering/workers-bindings/browser-rendering-with-do/) improves performance by eliminating the time that it takes to spin up a new browser session.
 
 </RelatedProduct>
 
 <RelatedProduct header="Agents" href="/agents/" product="agents">
 
-Build and deploy AI-powered agents that can autonomously perform tasks.
+Build AI-powered agents that autonomously navigate websites and perform tasks using [Playwright MCP](/browser-rendering/platform/playwright-mcp/) or [Stagehand](/browser-rendering/platform/stagehand/).
 
 </RelatedProduct>
 
@@ -78,8 +85,7 @@ Build and deploy AI-powered agents that can autonomously perform tasks.
 	href="/browser-rendering/get-started/"
 	icon="open-book"
 >
-	Deploy your first Browser Rendering project using Wrangler and Cloudflare's
-	version of Puppeteer.
+	Choose between REST API and Workers Bindings, then deploy your first project.
 </LinkTitleCard>
 
 <LinkTitleCard
@@ -99,11 +105,11 @@ Build and deploy AI-powered agents that can autonomously perform tasks.
 </LinkTitleCard>
 
 <LinkTitleCard
-	title="Learning Path"
-	href="/learning-paths/workers/concepts/"
+	title="Playwright API"
+	href="/browser-rendering/platform/playwright/"
 	icon="pen"
 >
-	New to Workers? Get started with the Workers Learning Path.
+	Use Cloudflare's fork of Playwright for testing and automation.
 </LinkTitleCard>
 
 <LinkTitleCard
