incorporate feedback on readme (#410)

* add a code sample to the readme

* indent

* indent

* act

* add section on how it works

* remove bb from readme

* why

* final

Author: kamath

README.md

@@ -41,15 +41,30 @@
 
 ---
 
-Stagehand is the easiest way to build browser automations. It is fully compatible with [Playwright](https://playwright.dev/), offering three simple AI APIs (`act`, `extract`, and `observe`) on top of the base Playwright `Page` class that provide the building blocks for web automation via natural language. It also makes Playwright more accessible to non-technical users and less vulnerable to minor changes in the UI/DOM.
+Stagehand is the easiest way to build browser automations. It is fully compatible with [Playwright](https://playwright.dev/), offering three simple AI APIs (`act`, `extract`, and `observe`) on top of the base Playwright `Page` class that provide the building blocks for web automation via natural language. 
 
-Anything that can be done in a browser can be done with Stagehand. Consider:
+Here's a sample of what you can do with Stagehand:
 
-1. Go to Hacker News and extract the top stories of the day
-1. Log into Amazon, search for AirPods, and buy the most relevant product
-1. Go to ESPN, search for Steph Curry, and get stats for his last 10 games
+```typescript
+// Keep your existing Playwright code unchanged
+await page.goto("https://docs.stagehand.dev");
 
-Stagehand makes it easier to write durable, performant browser automation code. When used with [Browserbase](https://browserbase.com/), it offers unparalleled debugging tools like session replay and step-by-step debugging.
+// Stagehand AI: Extract data from the page
+const { description } = await page.extract({
+  instruction: "Extract the description of the page",
+  schema: z.object({
+    description: z.string(),
+  }),
+});
+
+// Stagehand AI: Act on the page
+await page.act({ action: "click on the 'Quickstart'" });
+```
+
+## Why?
+**Stagehand adds determinism to otherwise unpredictable agents.**
+
+While there's no limit to what you could instruct Stagehand to do, our primitives allow you to control how much you want to leave to an AI. It works best when your code is a sequence of atomic actions. Instead of writing a single script for a single website, Stagehand allows you to write durable, self-healing, and repeatable web automation workflows that actually work.
 
 > [!NOTE] 
 > `Stagehand` is currently available as an early release, and we're actively seeking feedback from the community. Please join our [Slack community](https://join.slack.com/t/stagehand-dev/shared_invite/zt-2tdncfgkk-fF8y5U0uJzR2y2_M9c9OJA) to stay updated on the latest developments and provide feedback.