Improve readmes

Author: jmorrell

examples/worker-basic/README.md

@@ -4,7 +4,7 @@ Interactive playground for `@jmorrell/jsonrpc` on Cloudflare Workers.
 
 Defines a handful of toy RPC methods on the server and serves a static page
 where you can invoke them individually or in bulk. A toggle switches between
-**HTTP batch** and **WebSocket** transports — the server code is identical
+**HTTP batch** and **WebSocket** transports. The server code is identical
 because `newWorkersRpcResponse` routes both automatically.
 
 ## Running

examples/worker-bidirectional/README.md

@@ -2,16 +2,23 @@
 
 Bidirectional WebSocket RPC with a Durable Object audit log.
 
-The server defines the same toy methods as `worker-basic`, but each call also
-broadcasts an audit event to every connected client via `onEvent()` — a method
-the _server_ calls on the _client_. Open the page in two browser tabs and watch
-events from one tab appear in the other.
+We have a bidirectional RPC implementation, so we should use it, right?
+
+This demo has the server invoking remote methods on the client. Each call
+on the server emits an event to the client.
+
+It's worth calling out that you likely need some centralized state with this
+approach. A worker connected via a websocket could work in theory in that it
+can respond to requests coming in over the same connection. However if you have
+multiple sessions per user (think multiple tabs, or a desktop or mobile app) you
+likely want to send those requests to every session for a particular user.
+
+The best way to do that is a Durable Object. This demo app gives an example. Open
+the page in two browser tabs and watch events from one tab appear in the other.
 
 ## Setting up a bi-directional WebSocket RPC session
 
-The main difference between this example and `worker-basic` is that we're explicitly setting up a bi-directional WebSocket RPC session with `newWorkersWebSocketRpcSession`. This returns the upgrade
-response and an `RpcSession` — use `session.remote` to call methods on the client, and
-`session.onClose()` to clean up when the connection drops.
+The main difference between this example and `worker-basic` is that we're explicitly setting up a bi-directional WebSocket RPC session with `newWorkersWebSocketRpcSession`. This returns the upgrade response and an `RpcSession`. Use `session.remote` to call methods on the client, and `session.onClose()` to clean up when the connection drops.
 
 ```ts
 // Set up bidirectional RPC with the client
@@ -48,7 +55,7 @@ Open http://localhost:8787.
 
 ```
 src/worker.ts          Worker + AuditLog Durable Object
-web/src/app.ts         Client — bidirectional RPC with onEvent handler
+web/src/app.ts         Client - bidirectional RPC with onEvent handler
 web/src/style.css      Styles (two-column layout)
 web/index.html         Vite entry point
 web/vite.config.ts     Aliases @jmorrell/jsonrpc to the local dist build