Skip to content

Conversation

@irvinebroque
Copy link
Contributor

It is confusing to say that the binding name is MY_DURABLE_OBJECT — singular — and then call methods on it in order to....get a single Durable Objects instance.

I don't think this creates the correct mental model, makes it seem like MY_DURABLE_OBJECT is a single durable object, instead of what it is — a namepaces of Durable Objects — plural.

Something I am missing as to why we don't use this language today?

It is confusing to say that the binding name is `MY_DURABLE_OBJECT` — singular — and then call methods on it in order to....get a single Durable Objects instance.

I don't think this creates the correct mental model, makes it seem like `MY_DURABLE_OBJECT` is a single durable object, instead of what it is — a namepaces of Durable Objects — plural.
@hyperlint-ai
Copy link
Contributor

hyperlint-ai bot commented Jun 6, 2025

Howdy and thanks for contributing to our repo. The Cloudflare team reviews new, external PRs within two (2) weeks. If it's been two weeks or longer without any movement, please tag the PR Assignees in a comment.

We review internal PRs within 1 week. If it's something urgent or has been sitting without a comment, start a thread in the Developer Docs space internally.


PR Change Summary

Updated the Durable Object binding name for clarity and consistency in documentation.

  • Renamed the Durable Object binding from MY_DURABLE_OBJECT to MY_DURABLE_OBJECT_NAMESPACE for better clarity.
  • Updated code examples to reflect the new binding name throughout the documentation.
  • Modified the Wrangler configuration example to use the new binding name.

Modified Files

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

How can I customize these reviews?

Check out the Hyperlint AI Reviewer docs for more information on how to customize the review.

If you just want to ignore it on this PR, you can add the hyperlint-ignore label to the PR. Future changes won't trigger a Hyperlint review.

Note specifically for link checks, we only check the first 30 links in a file and we cache the results for several hours (for instance, if you just added a page, you might experience this). Our recommendation is to add hyperlint-ignore to the PR to ignore the link check for this PR.

@github-actions github-actions bot added size/s product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ labels Jun 6, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Jun 6, 2025

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/durable-objects/ @elithrar, @vy-ton, @joshthoward, @oxyjun, @harshil1712, @cloudflare/pcx-technical-writing

@irvinebroque irvinebroque marked this pull request as ready for review June 25, 2025 15:43
Copy link
Contributor Author

@irvinebroque irvinebroque left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@vy-ton you good with this? any concerns?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants