docs(deployment): recommend Cloudflare Workers over Cloudflare Pages

[acosoft]

Pre-flight checklist

• I have read the Contributing Guidelines on pull requests.
• If this is a code change: I have written unit tests and/or added dogfooding pages to fully verify the new behavior.
• If this is a new API or substantial change: the PR has an accompanying issue (closes #0000) and the maintainers have approved on my working plan.

Motivation

• Cloudflare Workers are the modern, recommended way to deploy Docusaurus sites.
• This change helps new users follow best practices.
• https://developers.cloudflare.com/pages/framework-guides/deploy-a-docusaurus-site/
• https://developers.cloudflare.com/workers/static-assets/migration-guides/migrate-from-pages/

Test Plan

• Verified documentation renders correctly in local development
  /docs/deployment#deploying-to-cloudflare
• Verified documentation renders correctly on test environment
  https://deploy-preview-11673--docusaurus-2.netlify.app/docs/deployment/#deploying-to-cloudflare

[netlify]

✅ [V2]

Built without sensitive environment variables

Name	Link
🔨 Latest commit	22f1c62
🔍 Latest deploy log	https://app.netlify.com/projects/docusaurus-2/deploys/697250ebc525350008346d13
😎 Deploy Preview	https://deploy-preview-11673--docusaurus-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[slorber]

Cloudflare Workers are the modern, recommended way to deploy Docusaurus sites.

Can you please back your claim with a resource from Cloudflare that says so?

https://blog.cloudflare.com/full-stack-development-on-cloudflare-workers/

Before, building an app on Pages meant you got a really easy, opinionated on-ramp, but you’d eventually hit a wall if your application got more complex.

We actually value the easy, opinionated path, because Docusaurus is a static site generator and usually doesn't need the full power of Workers.

For that reason, I still think that, for our specific framework, Pages is the experience we should recommend.

However, we can also tell users that it's possible to host on Workers if they have more advanced needs.