Lifecycle of a DO doc initialisation

Author: Oxyjun

public/__redirects

@@ -492,6 +492,8 @@
 /durable-objects/get-started/video-series/serverless-websocket/ /durable-objects/video-tutorials/ 301
 /durable-objects/get-started/video-series/ /durable-objects/video-tutorials/ 301
 
+/durable-objects/what-are-durable-objects/ /durable-objects/concepts/what-are-durable-objects/ 301
+
 # email-routing
 /email-routing/enable-email-routing/ /email-routing/get-started/enable-email-routing/ 301
 /email-routing/get-started/email-addresses/ /email-routing/setup/email-routing-addresses/ 301

src/content/changelog/durable-objects/2025-04-07-durable-objects-free-tier.mdx

@@ -45,5 +45,5 @@ Free plan [limits](/durable-objects/platform/pricing/) apply to Durable Objects
 
 For more information, checkout:
 
-- [Documentation](/durable-objects/what-are-durable-objects/)
+- [Documentation](/durable-objects/concepts/what-are-durable-objects/)
 - [Zero-latency SQLite storage in every Durable Object blog](https://blog.cloudflare.com/sqlite-in-durable-objects/)

src/content/changelog/durable-objects/2025-06-25-actors-package-alpha.mdx

@@ -11,7 +11,7 @@ The new [@cloudflare/actors](https://www.npmjs.com/package/@cloudflare/actors) l
 
 The `@cloudflare/actors` library is a new SDK for Durable Objects and provides a powerful set of abstractions for building real-time, interactive, and multiplayer applications on top of Durable Objects. With beta uasge and feedback, `@cloudflare/actors` will become the recommended way to build on Durable Objects and draws upon Cloudflare's experience building products/features on Durable Objects.
 
-The name "actors" originates from the [actor programming model](/durable-objects/what-are-durable-objects/#actor-programming-model), which closely ties to how Durable Objects are modelled.
+The name "actors" originates from the [actor programming model](/durable-objects/concepts/what-are-durable-objects/#actor-programming-model), which closely ties to how Durable Objects are modelled.
 
 The `@cloudflare/actors` library includes:
 
@@ -28,7 +28,7 @@ import { Storage } from "@cloudflare/actors/storage";
 
 export class ChatRoom extends DurableObject<Env> {
     storage: Storage;
-    
+
     constructor(ctx: DurableObjectState, env: Env) {
         super(ctx, env)
         this.storage = new Storage(ctx.storage);
@@ -50,7 +50,7 @@ export class ChatRoom extends DurableObject<Env> {
 }
 ```
 
-`@cloudflare/actors` library introduces the `Actor` class pattern. `Actor` lets you access Durable Objects without writing the Worker that communicates with your Durable Object (the Worker is created for you). By default, requests are routed to a Durable Object named "default". 
+`@cloudflare/actors` library introduces the `Actor` class pattern. `Actor` lets you access Durable Objects without writing the Worker that communicates with your Durable Object (the Worker is created for you). By default, requests are routed to a Durable Object named "default".
 
 ```js
 export class MyActor extends Actor<Env> {

src/content/changelog/workers/2025-05-14-python-worker-durable-object.mdx

@@ -11,9 +11,9 @@ import { WranglerConfig } from "~/components";
 
 You can now create [Durable Objects](/durable-objects/) using
 [Python Workers](/workers/languages/python/). A Durable Object is a special kind of
-Cloudflare Worker which uniquely combines compute with storage, enabling stateful 
+Cloudflare Worker which uniquely combines compute with storage, enabling stateful
 long-running applications which run close to your users. For more info see
-[here](https://developers.cloudflare.com/durable-objects/what-are-durable-objects/).
+[here](/durable-objects/concepts/what-are-durable-objects/).
 
 You can define a Durable Object in Python in a similar way to JavaScript:
 
@@ -26,7 +26,7 @@ class MyDurableObject(DurableObject):
     def __init__(self, ctx, env):
         self.ctx = ctx
         self.env = env
-    
+
     def on_fetch(self, request):
         result = self.ctx.storage.sql.exec("SELECT 'Hello, World!' as greeting").one()
         return Response(result.greeting)

src/content/docs/agents/platform/limits.mdx

@@ -22,7 +22,7 @@ Many limits are inherited from those applied to Workers scripts and/or Durable O
 
 ---
 
-[^1]: Yes, really. You can have tens of millions of Agents running concurrently, as each Agent is mapped to a [unique Durable Object](/durable-objects/what-are-durable-objects/) (actor).
+[^1]: Yes, really. You can have tens of millions of Agents running concurrently, as each Agent is mapped to a [unique Durable Object](/durable-objects/concepts/what-are-durable-objects/) (actor).
 [^2]: You can deploy up to [500 scripts per account](/workers/platform/limits/), but each script (project) can define multiple Agents. Each deployed script can be up to 10 MB on the [Workers Paid Plan](/workers/platform/pricing/#workers)
 [^3]: Compute (CPU) time per Agent is limited to 30 seconds, but this is refreshed when an Agent receives a new HTTP request, runs a [scheduled task](/agents/api-reference/schedule-tasks/), or an incoming WebSocket message.
 

src/content/docs/durable-objects/concepts/durable-object-lifecycle.mdx

@@ -0,0 +1,21 @@
+---
+title: The Lifecycle of a Durable Object
+pcx_content_type: concept
+sidebar:
+  order: 3
+
+---
+
+import { Render, TypeScriptExample } from "~/components";
+
+This section describes the lifecycle of a [Durable Object](/durable-objects/concepts/what-are-durable-objects/).
+
+To use a Durable Object you need to create a [Durable Object Stub](/durable-objects/api/stub/). In its simplest form, this looks like the following snippet:
+
+```ts
+// Assume a DurableObjectNamespace binding MY_DURABLE_OBJECT
+// Every unique ID refers to an individual instance of the Durable Object class
+const id = env.MY_DURABLE_OBJECT.idFromName("foo");
+const stub = env.MY_DURABLE_OBJECT.get(id);
+```
+

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

@@ -0,0 +1,12 @@
+---
+title: Concepts
+pcx_content_type: navigation
+sidebar:
+  order: 3
+  group:
+    hideIndex: true
+---
+
+import { DirectoryListing } from "~/components";
+
+<DirectoryListing />

src/content/docs/durable-objects/what-are-durable-objects.mdx renamed to src/content/docs/durable-objects/concepts/what-are-durable-objects.mdx

@@ -14,7 +14,7 @@ This guide will instruct you through:
 - Instantiating and communicating with a Durable Object from another Worker.
 - Deploying a Durable Object and a Worker that communicates with a Durable Object.
 
-If you wish to learn more about Durable Objects, refer to [What are Durable Objects?](/durable-objects/what-are-durable-objects/).
+If you wish to learn more about Durable Objects, refer to [What are Durable Objects?](/durable-objects/concepts/what-are-durable-objects/).
 
 ## Quick start
 

src/content/docs/durable-objects/get-started.mdx

@@ -34,7 +34,7 @@ SQLite-backed Durable Objects are now available on the Workers Free plan with th
 
 <Render file="what-are-durable-objects"/>
 
-For more information, refer to the full [What are Durable Objects?](/durable-objects/what-are-durable-objects/) page.
+For more information, refer to the full [What are Durable Objects?](/durable-objects/concepts/what-are-durable-objects/) page.
 
 ***