Skip to content

Commit 00ca7a9

Browse files
authored
Improve Durable Objects intro by saying what it does. (#19298)
* Improve Durable Objects intro by saying what it does. There is a lot of debate about how best to present DOs so that people "get it". Engineers (like me) usually want to know what a product *does*. This is contrary to the common wisdom that product pages should say what problems a product *solves*. Figuring out how to use a tool to solve a problem is an engineer's job, so as long as they know what it does, they can figure out what it solves. Conversely, if you only tell them what it solves, they then cannot visualize *how* it solves the problem, which is their job, so they get frustrated. To that end, we should very briefly explain what a Durable Object *does* right on the landing page.
1 parent 97f12e9 commit 00ca7a9

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

src/content/docs/durable-objects/index.mdx

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,18 @@ Create collaborative applications, real-time chat, multiplayer games and more wi
1919

2020
<Plan type="paid" />
2121

22-
Durable Objects provide a powerful compute API for coordinating multiple clients or users. Each Durable Object has private, transactional and strongly consistent storage attached.
22+
Durable Objects provide a building block for stateful applications and distributed systems.
2323

24-
Use Durable Objects to build collaborative editing tools, interactive chat, multiplayer games and applications that need coordination among multiple clients, without requiring you to build serialization and coordination primitives on your own.
24+
Use Durable Objects to build applications that need cordination among multiple clients, like collaborative editing tools, interactive chat, multiplayer games, and deep distributed systems, without requiring you to build serialization and coordination primitives on your own.
25+
26+
### What is a Durable Object?
27+
28+
A Durable Object is a special kind of [Worker](/workers/). Like a Worker, it is automatically provisioned geographically close to where it is requested, it starts up quickly when needed and shuts down when idle, and you can have millions of them around the world. However, unlike regular Workers:
29+
30+
* Each object has a **globally-unique name**, allowing you to send requests to a specific object from anywhere in the world. Thus, a Durable Object can be used to coordinate between multiple clients who need to work together.
31+
* Each object has some **durable storage** attached. Since this storage lives together with the object, it is strongly consistent yet fast to access.
32+
33+
Thus, Durable Objects enable **stateful** serverless applications.
2534

2635
<LinkButton href="/durable-objects/get-started/walkthrough/">Get started</LinkButton>
2736

0 commit comments

Comments
 (0)