Address remaining comments

Author: joshthoward

src/content/docs/durable-objects/api/alarms.mdx

@@ -37,15 +37,19 @@ Alarms can be used to build distributed primitives, like queues or batching of w
 
 ### getAlarm
 
-- <code>getAlarm()</code>: <Type text ='number | null' />
+- <code>getAlarm()</code>: <Type text="number | null" />
 
   - If there is an alarm set, then return the currently set alarm time as the number of milliseconds elapsed since the UNIX epoch. Otherwise, return `null`.
 
 ### setAlarm
 
-- <code> setAlarm(scheduledTimeMs <Type text="number" />)</code>: <Type text="void" />
+- <code>
+  	{" "}
+  	setAlarm(scheduledTimeMs <Type text="number" />)
+  </code>
+  : <Type text="void" />
 
-  - Set the time for the alarm to run.  Specify the time as the number of milliseconds elapsed since the UNIX epoch.
+  - Set the time for the alarm to run. Specify the time as the number of milliseconds elapsed since the UNIX epoch.
 
 ### deleteAlarm
 
@@ -72,7 +76,7 @@ Alarms can be used to build distributed primitives, like queues or batching of w
 This example shows how to both set alarms with the `setAlarm(timestamp)` method and handle alarms with the `alarm()` handler within your Durable Object.
 
 - The `alarm()` handler will be called once every time an alarm fires.
-- If an unexpected error terminates the Durable Object, the `alarm()` handler will be re-instantiated on another machine.
+- If an unexpected error terminates the Durable Object, the `alarm()` handler may be re-instantiated on another machine.
 - Following a short delay, the `alarm()` handler will run from the beginning on the other machine.
 
 ```js

src/content/docs/durable-objects/api/id.mdx

@@ -23,31 +23,29 @@ If you are experiencing an issue with a particular Durable Object instance, you
 
 ### `toString`
 
-#### Description
-
 `toString` converts a `DurableObjectId` to a 64 digit hex string. This string is useful for logging purposes or storing the `DurableObjectId` elsewhere, for example, in a session cookie. This string can be used to reconstruct a `DurableObjectId` via `DurableObjectNamespace::idFromString`.
 
 ```js
 // Create a new unique ID
 const id = env.MY_DURABLE_OBJECT.newUniqueId();
-// Save the unique ID elsewhere, e.g. a session cookie via id.toString()
+// Convert the ID to a string to be saved elsewhere, e.g. a session cookie
+const session_id = id.toString();
+
 ...
 // Recreate the ID from the string
 const id = env.MY_DURABLE_OBJECT.idFromString(session_id);
 ```
 
 #### Parameters
 
-None.
+- None.
 
-#### Return value
+#### Return values
 
-A 64 digit hex string.
+- A 64 digit hex string.
 
 ### `equals`
 
-#### Description
-
 `equals` is used to compare equality between two instances of `DurableObjectId`.
 
 ```js
@@ -58,25 +56,26 @@ console.assert(!id1.equals(id2), "Different unique ids should never be equal.");
 
 #### Parameters
 
-A required `DurableObjectId` to compare against.
+- A required `DurableObjectId` to compare against.
 
-#### Return value
+#### Return values
 
-A boolean. True if equal and false otherwise.
+- A boolean. True if equal and false otherwise.
 
 ## Properties
 
 ### `name`
 
-#### Description
-
 `name` is an optional property of a `DurableObjectId`, which returns the name that was used to create the `DurableObjectId` via [`DurableObjectNamespace::idFromName`](/durable-objects/api/namespace/#idfromname). This value is undefined if the `DurableObjectId` was constructed using [`DurableObjectNamespace::newUniqueId`](/durable-objects/api/namespace/#newuniqueid).
 
 ```js
 const uniqueId = env.MY_DURABLE_OBJECT.newUniqueId();
 const fromNameId = env.MY_DURABLE_OBJECT.idFromName("foo");
 console.assert(uniqueId.name === undefined, "unique ids have no name");
-console.assert(fromNameId.name === "foo", "name matches parameter to idFromName");
+console.assert(
+	fromNameId.name === "foo",
+	"name matches parameter to idFromName",
+);
 ```
 
 ## Related resources

src/content/docs/durable-objects/api/namespace.mdx

@@ -29,7 +29,7 @@ export default {
     // Every unique ID refers to an individual instance of the Durable Object class
     const id = env.MY_DURABLE_OBJECT.idFromName("foo");
 
-    // A stub is a client Object used to invoke methods on the Durable Object instance.
+    // A stub is a client Object used to invoke methods defined by the Durable Object instance
     const stub = env.MY_DURABLE_OBJECT.get(id);
     ...
   }
@@ -56,7 +56,7 @@ export default {
     // Every unique ID refers to an individual instance of the Durable Object class
     const id = env.MY_DURABLE_OBJECT.idFromName("foo");
 
-    // A stub is a client used to invoke methods on the Durable Object instance.
+    // A stub is a client Object used to invoke methods defined by the Durable Object instance
     const stub = env.MY_DURABLE_OBJECT.get(id);
     ...
   }
@@ -69,8 +69,6 @@ export default {
 
 ### `idFromName`
 
-#### Description
-
 `idFromName` creates a [`DurableObjectId`](/durable-objects/api/id) which refers to an individual instance of the Durable Object class from a particular name.
 
 ```js
@@ -80,16 +78,14 @@ const barId = env.MY_DURABLE_OBJECT.idFromName("bar");
 
 #### Parameters
 
-The string to be used to generate a [`DurableObjectId`](/durable-objects/api/id) corresponding to the name of a Durable Object instance.
+- A required string to be used to generate a [`DurableObjectId`](/durable-objects/api/id) corresponding to the name of a Durable Object instance.
 
-#### Return value
+#### Return values
 
-A [`DurableObjectId`](/durable-objects/api/id) referring to an instance of a Durable Object class.
+- A [`DurableObjectId`](/durable-objects/api/id) referring to an instance of a Durable Object class.
 
 ### `newUniqueId`
 
-#### Description
-
 `newUniqueId` creates a `DurableObjectId` which refers to an individual instance of the Durable Object class.
 
 ```js
@@ -105,16 +101,14 @@ IDs created by `newUniqueId` will result in lower latencies when getting a [`Dur
 
 #### Parameters
 
-An optional object with the key `jurisdiction` and value of a [jurisdiction](/durable-objects/reference/data-location/#restrict-durable-objects-to-a-jurisdiction) string.
+- An optional object with the key `jurisdiction` and value of a [jurisdiction](/durable-objects/reference/data-location/#restrict-durable-objects-to-a-jurisdiction) string.
 
-#### Return value
+#### Return values
 
-A [`DurableObjectId`](/durable-objects/api/id) referring to an instance of the Durable Object class.
+- A [`DurableObjectId`](/durable-objects/api/id) referring to an instance of the Durable Object class.
 
 ### `idFromString`
 
-#### Description
-
 `idFromString` creates a [`DurableObjectId`](/durable-objects/api/id) from a previously generated ID that has been converted to a string. This method ensures the ID is valid, for example, it checks that the ID consists of 64 hex digits.
 
 ```js
@@ -128,16 +122,14 @@ const id = env.MY_DURABLE_OBJECT.idFromString(session_id);
 
 #### Parameters
 
-The string corresponding to a [`DurableObjectId`](/durable-objects/api/id) previously generated either by `newUniqueId` or `idFromName`.
+- A required string corresponding to a [`DurableObjectId`](/durable-objects/api/id) previously generated either by `newUniqueId` or `idFromName`.
 
-#### Return value
+#### Return values
 
-A [`DurableObjectId`](/durable-objects/api/id) referring to an instance of a Durable Object class.
+- A [`DurableObjectId`](/durable-objects/api/id) referring to an instance of a Durable Object class.
 
 ### `get`
 
-#### Description
-
 `get` obtains a [`DurableObjectStub`](/durable-objects/api/stub) from a [`DurableObjectId`](/durable-objects/api/id) which can be used to invoke methods on a Durable Object instance.
 
 ```js
@@ -147,16 +139,14 @@ const stub = env.MY_DURABLE_OBJECT.get(id);
 
 #### Parameters
 
-A required [`DurableObjectId`](/durable-objects/api/id) and an optional object with the key `locationHint` and value of a [locationHint](/durable-objects/reference/data-location/#provide-a-location-hint) string.
+- A required [`DurableObjectId`](/durable-objects/api/id) and an optional object with the key `locationHint` and value of a [locationHint](/durable-objects/reference/data-location/#provide-a-location-hint) string.
 
-#### Return value
+#### Return values
 
-A [`DurableObjectStub`](/durable-objects/api/stub) referring to an instance of a Durable Object class.
+- A [`DurableObjectStub`](/durable-objects/api/stub) referring to an instance of a Durable Object class.
 
 ### `jurisdiction`
 
-#### Description
-
 `jurisdiction` creates a subnamespace from a namespace where all Durable Object instance IDs and references created from that subnamespace will be restricted to the specified [jurisdiction](/durable-objects/reference/data-location/#restrict-durable-objects-to-a-jurisdiction).
 
 ```js
@@ -166,13 +156,13 @@ const euId = subnamespace.idFromName("foo");
 
 #### Parameters
 
-A required [jurisdiction](/durable-objects/reference/data-location/#restrict-durable-objects-to-a-jurisdiction) string.
+- A required [jurisdiction](/durable-objects/reference/data-location/#restrict-durable-objects-to-a-jurisdiction) string.
 
-#### Return value
+#### Return values
 
-A `DurableObjectNamespace` scoped to a particular geographic jurisdiction.
+- A `DurableObjectNamespace` scoped to a particular geographic jurisdiction.
 
 ## Related resources
 
 - [Durable Objects: Easy, Fast, Correct – Choose Three](https://blog.cloudflare.com/durable-objects-easy-fast-correct-choose-three/).
-- [Durable Objects best practices](/durable-objects/best-practices/access-durable-objects-from-a-worker/).
+- [Durable Objects best practices](/durable-objects/best-practices/access-durable-objects-from-a-worker/).

src/content/docs/durable-objects/api/stub.mdx

@@ -59,7 +59,7 @@ export class MyDurableObject extends DurableObject {
 		super(ctx, env);
 	}
 
-	sayHello(): String {
+	async sayHello(): String {
 		return "Hello, World!";
 	}
 }
@@ -74,7 +74,7 @@ export default {
 		const stub = env.MY_DURABLE_OBJECT.get(id);
 
 		// Methods on the Durable Object are invoked via the stub
-		const rpcResponse = stub.sayHello();
+		const rpcResponse = await stub.sayHello();
 
 		return new Response(rpcResponse);
 	},
@@ -87,8 +87,6 @@ export default {
 
 ### `id`
 
-#### Description
-
 `id` is a property of the `DurableObjectStub` corresponding to the [`DurableObjectId`](/durable-objects/api/id) used to create the stub.
 
 ```js
@@ -99,8 +97,6 @@ console.assert(id.equals(stub.id), "This should always be true");
 
 ### `name`
 
-#### Description
-
 `name` is an optional property of a `DurableObjectStub`, which returns the name that was used to create the [`DurableObjectId`](/durable-objects/api/id) via [`DurableObjectNamespace::idFromName`](/durable-objects/api/namespace/#idfromname) which was then used to create the `DurableObjectStub`. This value is undefined if the [`DurableObjectId`](/durable-objects/api/id) used to create the `DurableObjectStub` was constructed using [`DurableObjectNamespace::newUniqueId`](/durable-objects/api/namespace/#newuniqueid).
 
 ```js