Updates per feedback

Author: mikenomitch

src/content/docs/workers/languages/python/basics.mdx

@@ -149,15 +149,21 @@ and compatibility_flags in your config file.
 
 ## Upgrading `pywrangler`
 
-To upgrade to the latest version of `pywrangler`, run the following command:
+To upgrade to the latest version of `pywrangler` globally, run the following command:
 
 ```bash
 uv tool upgrade workers-py
 ```
 
+To upgrade to the latest version of `pywrangler` in a specific project, run the following command:
+
+```bash
+uv lock --upgrade-package workers-py
+```
+
 ## Next Up
 
-- Learn details about local development, deployment, and [how to Python Workers work](/workers/languages/python/how-python-workers-work).
+- Learn details about local development, deployment, and [how Python Workers work](/workers/languages/python/how-python-workers-work).
 - Explore the [package](/workers/languages/python/packages) docs for instructions on how to use packages with Python Workers.
 - Understand which parts of the [Python Standard Library](/workers/languages/python/stdlib) are supported in Python Workers.
 - Learn about Python Workers' [foreign function interface (FFI)](/workers/languages/python/ffi), and how to use it to work with [bindings](/workers/runtime-apis/bindings) and [Runtime APIs](/workers/runtime-apis/).

src/content/docs/workers/languages/python/examples.mdx

@@ -160,7 +160,7 @@ class List(DurableObject):
         await self.ctx.storage.put("messages", to_js(messages))
         return
 
-		async def say_hello(self):
+    async def say_hello(self):
         result = self.ctx.storage.sql.exec(
             "SELECT 'Hello, World!' as greeting"
         ).one()
@@ -180,7 +180,7 @@ class Default(WorkerEntrypoint):
   			print("cron processed")
 ```
 
-    Refer to [Cron Triggers documentation](/workers/configuration/cron-triggers/) for more information.
+Refer to [Cron Triggers documentation](/workers/configuration/cron-triggers/) for more information.
 
 ## Workflows
 

src/content/docs/workers/languages/python/ffi.mdx

@@ -52,7 +52,7 @@ Under the hood, `env` is actually a JavaScript object. When you call `.FOO`, you
 
 ### Converting Python to JavaScript
 
-Occasionally, to interoperate with JavaScript APIs, you may need to convert a Python objebect to JavaScript. Pyodide provides a `to_js` function to facilitate this conversion.
+Occasionally, to interoperate with JavaScript APIs, you may need to convert a Python object to JavaScript. Pyodide provides a `to_js` function to facilitate this conversion.
 
 ````python
 from js import Object
@@ -66,6 +66,8 @@ def to_js(obj):
 	```
 ````
 
+For more details, see out the [documentation on `pyodide.ffi.to_js`](https://pyodide.org/en/stable/usage/api/python-api/ffi.html#pyodide.ffi.to_js).
+
 ## Using JavaScript globals from Python Workers
 
 When writing Workers in Python, you can access JavaScript globals by importing them from the `js` module. For example, note how `Response` is imported from `js` in the example below:

src/content/docs/workers/languages/python/how-python-workers-work.mdx

@@ -16,7 +16,7 @@ When you write a Python Worker, your code is interpreted directly by Pyodide, wi
 
 ## Local Development
 
-A basic Python Worker includes a Python file with an `Default` class extending `WorkerEntrypoint`, such as:
+A basic Python Worker includes a Python file with a `Default` class extending `WorkerEntrypoint`, such as:
 
 ```python
 from workers import Response, WorkerEntrypoint

src/content/docs/workers/languages/python/index.mdx

@@ -15,7 +15,6 @@ import { WranglerConfig } from "~/components";
 
 Cloudflare Workers provides a first-class Python experience, including support for:
 
-- The majority of Python's [Standard library](/workers/languages/python/stdlib/)
 - Easy to install and fast-booting [Packages](/workers/languages/python/packages), including [FastAPI](https://fastapi.tiangolo.com/), [Langchain](https://pypi.org/project/langchain/), [httpx](https://www.python-httpx.org/), [Pydantic](https://docs.pydantic.dev/latest/) and more.
 - A robust [foreign function interface (FFI)](/workers/languages/python/ffi) that lets you use JavaScript objects and functions directly from Python — including all [Runtime APIs](/workers/runtime-apis/)
 - An ecosystem of services on the Workers Platform accessible via [bindings](/workers/runtime-apis/bindings/), including:
@@ -25,15 +24,6 @@ Cloudflare Workers provides a first-class Python experience, including support f
   - File storage with [R2](/r2)
   - [Durable Workflows](/workflows/), [Queues](/queues/), and [ more](/workers/runtime-apis/bindings/)
 
-:::caution[Python Workers are in beta.]
-
-You must add the `python_workers` compatibility flag to your Worker, while Python Workers are in open beta. Packages are supported using the [pywrangler](/workers/languages/python/packages) tool.
-
-We also recommend using the `python_dedicated_snapshot` for improved performance when using packages.
-
-We'd love your feedback. Join the #python-workers channel in the [Cloudflare Developers Discord](https://discord.cloudflare.com/) and let us know what you'd like to see next.
-:::
-
 ## Introduction
 
 A Python Worker can be as simple as four lines of code:
@@ -51,6 +41,13 @@ sent to the Worker.
 
 In a Python Worker, this handler is placed in a `Default` class that extends the `WorkerEntrypoint` class (which you can import from the `workers` SDK module).
 
+:::caution[Python Workers are in beta.]
+
+You must add the `python_workers` compatibility flag to your Worker, while Python Workers are in open beta. Packages are supported using the [pywrangler](/workers/languages/python/packages) tool.
+
+We'd love your feedback. Join the #python-workers channel in the [Cloudflare Developers Discord](https://discord.cloudflare.com/) and let us know what you'd like to see next.
+:::
+
 ### The `pywrangler` CLI tool
 
 To run a Python Worker locally, install packages, and deploy it to Cloudflare, you use [pywrangler](https://github.com/cloudflare/workers-py),
@@ -80,7 +77,7 @@ To deploy a Python Worker to Cloudflare, run `pywrangler deploy`:
 uv run pywrangler deploy
 ```
 
-### Python Worker Templaes
+### Python Worker Templates
 
 When you initialize a new Python Worker project and select from one of many templates:
 

src/content/docs/workers/languages/python/packages/fastapi.mdx

@@ -21,7 +21,7 @@ Clone the `cloudflare/python-workers-examples` repository and run the FastAPI ex
 ```bash
 git clone https://github.com/cloudflare/python-workers-examples
 cd python-workers-examples/03-fastapi
-npx wrangler@latest dev
+uv run pywrangler dev
 ```
 
 ### Example code

src/content/docs/workers/languages/python/packages/langchain.mdx

@@ -23,7 +23,7 @@ Clone the `cloudflare/python-workers-examples` repository and run the LangChain
 ```bash
 git clone https://github.com/cloudflare/python-workers-examples
 cd 04-langchain
-npx wrangler@latest dev
+uv run pywrangler dev
 ```
 
 ### Example code

src/content/docs/workers/runtime-apis/handlers/scheduled.mdx

@@ -61,7 +61,7 @@ from workers import WorkerEntrypoint, Response, fetch
 
 class Default(WorkerEntrypoint):
     async def scheduled(self, controller, env, ctx):
-  			ctx.waitUntil(doSomeTaskOnASchedule())
+        ctx.waitUntil(doSomeTaskOnASchedule())
 ```
 
 </TabItem></Tabs>
@@ -87,5 +87,9 @@ class Default(WorkerEntrypoint):
 
 When a Workers script is invoked by a [Cron Trigger](/workers/configuration/cron-triggers/), the Workers runtime starts a `ScheduledEvent` which will be handled by the `scheduled` function in your Workers Module class. The `ctx` argument represents the context your function runs in, and contains the following methods to control what happens next:
 
-- <code>ctx.waitUntil(promisePromise)</code> : void
-  - Use this method to notify the runtime to wait for asynchronous tasks (for example, logging, analytics to third-party services, streaming and caching). The first `ctx.waitUntil` to fail will be observed and recorded as the status in the [Cron Trigger](/workers/configuration/cron-triggers/) Past Events table. Otherwise, it will be reported as a success.
+- <code>ctx.waitUntil(promisePromise)</code> : void - Use this method to notify
+  the runtime to wait for asynchronous tasks (for example, logging, analytics to
+  third-party services, streaming and caching). The first `ctx.waitUntil` to
+  fail will be observed and recorded as the status in the [Cron
+  Trigger](/workers/configuration/cron-triggers/) Past Events table. Otherwise,
+  it will be reported as a success.

src/content/docs/workflows/python/bindings.mdx

@@ -93,9 +93,8 @@ The `create` method returns a [`WorkflowInstance`](/workflows/build/workers-api/
 
 Create (trigger) a batch of new workflow instances, up to 100 instances at a time. This is useful if you need to create multiple instances at once within the [instance creation limit](/workflows/reference/limits/).
 
-- <code>create_batch(batch)</code>* `batch` - list of
-  `WorkflowInstanceCreateOptions` to pass when creating an instance, including a
-  user-provided ID and payload parameters.
+* <code>create_batch(batch)</code>
+  * `batch` - list of `WorkflowInstanceCreateOptions` to pass when creating an instance, including a user-provided ID and payload parameters.
 
 Each element of the `batch` list is expected to include both `id` and `params` properties: