Clarification that 'fetch' is not recommended

[chris-martin]

Existing documentation URL(s)

• https://developers.cloudflare.com/durable-objects/api/base/
• https://developers.cloudflare.com/durable-objects/best-practices/create-durable-object-stubs-and-send-requests/

What changes are you suggesting?

Best practices recommends against calling fetch on a Durable Object class. I was surprised to then see fetch as the first method listed on the DurableObject API documentation. The two pages seem to contradict one another, and this makes me question my understanding (for context, I have started reading about durable objects only just yesterday); I would have expected fetch to be listed last in the API doc and to include a note of discouragement similar to what the best practices page recommends.

Additional information

No response

[Oxyjun]

Hi @chris-martin , we'll add a note to re-emphasise that the fetch exists for legacy projects.

[chris-martin]

Thanks, I really appreciate y'all being responsive to my questions. It means a lot to my confidence in using this service 👍