Skip to content

Commit d10e52f

Browse files
authored
Merge pull request #44 from cardmagic/docs/tighten-readme
docs: tighten the README prose
2 parents 48bd44c + 6d87551 commit d10e52f

1 file changed

Lines changed: 4 additions & 6 deletions

File tree

‎README.md‎

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -138,8 +138,7 @@ policies must bind actor IDs and operations to the authenticated user or tenant.
138138
139139
The handwritten version usually starts with a row lock. Then it gains an
140140
`expiresAt` column, a sweeper, retries, per-room ordering, and a broadcast path
141-
that must agree with the write. The original transaction has developed a robust
142-
interplay with four other subsystems.
141+
that must agree with the write. The original transaction now depends on four other subsystems.
143142
144143
Solid Objects makes the application-defined identity the coordination boundary.
145144
Its state, mailbox, retries, reminders, and staged consequences live in SQLite,
@@ -153,8 +152,7 @@ required. Redis is optional wake-up plumbing, not durable state.
153152
- Accounts, devices, and long-lived jobs whose next action depends on committed state.
154153
- Realtime multi-user state where publications must follow committed revisions.
155154
156-
Different identities can run concurrently. One global identity is merely a
157-
queue wearing an ambitious name.
155+
Different identities can run concurrently. One global identity serializes everything.
158156
159157
## Solid Objects in the browser
160158
@@ -233,7 +231,7 @@ The wire shapes are documented in the
233231
## When a transaction is better
234232
235233
Often. If all the work happens in one request, use a transaction, constraint, or
236-
`SELECT ... FOR UPDATE`. It is smaller, faster, and does not need a manifesto.
234+
`SELECT ... FOR UPDATE`. It is smaller and faster.
237235
238236
Use Solid Objects when the critical section outlives that transaction: work
239237
must happen later, survive a restart, or remain ordered across several requests
@@ -250,7 +248,7 @@ or jobs. A plain counter is not a reason to install this package.
250248
- Background work needs `runtime.run(signal)`. If no process is running, committed work waits in SQL rather than disappearing.
251249
- Your application still owns authorization, database backups, failover, WebSocket transport, and capacity planning.
252250
253-
Exactly once remains absent, despite its excellent branding. Read the
251+
There is no exactly-once delivery. Read the
254252
[correctness contract](docs/correctness.md) before using important data.
255253
256254
## Read more

0 commit comments

Comments
 (0)