diff --git a/src/content/docs/durable-objects/examples/alarms-api.mdx b/src/content/docs/durable-objects/examples/alarms-api.mdx
index d813dfe402eb92f..b9f5bf21296d179 100644
--- a/src/content/docs/durable-objects/examples/alarms-api.mdx
+++ b/src/content/docs/durable-objects/examples/alarms-api.mdx
@@ -15,7 +15,11 @@ description: Use the Durable Objects Alarms API to batch requests to a Durable O
 
 import { GlossaryTooltip, WranglerConfig } from "~/components";
 
-This example implements an <GlossaryTooltip term="alarm">`alarm()`</GlossaryTooltip> handler that wakes the Durable Object once every 10 seconds to batch requests to a single Durable Object. The `alarm()` handler will delay processing until there is enough work in the queue.
+This example implements an <GlossaryTooltip term="alarm">`alarm()`</GlossaryTooltip> handler that allows batching of requests to a single Durable Object.
+
+When a request is received and no alarm is set, it sets an alarm for 10 seconds in the future. The `alarm()` handler processes all requests received within that 10-second window.
+
+If no new requests are received, no further alarms will be set until the next request arrives.
 
 ```js
 import { DurableObject } from 'cloudflare:workers';