Astro docs contradict Cloudflare docs on necessity of wrangler.jsonc

[dschuessler]

📚 Subject area/topic

Migration to Astro 6 and Cloudflare integration v13

📋 Page(s) affected (or suggested, for new content)

https://docs.astro.build/en/guides/integrations-guide/cloudflare/#upgrading-to-v13-and-astro-6

📋 Description of content that is out-of-date or incorrect

In the migration guide to Astro 6 and Cloudflare integration v13, there are two claims.

1. The wrangler configuration file is now optional.
2. Cloudflare Pages support has been removed.

When I follow the link to the migration guide from Cloudflare Pages to Cloudflare Workers, it claims "If your Pages project uses a popular framework, most frameworks already have adapters available for Cloudflare Workers." However, when I follow the link to the framework guides, and select Astro, I am prompted to write a wrangler configuration, contradicting claim 1.

Which is it? Is the wrangler configuration optional or mandatory?

🖥️ Reproduction in StackBlitz (if reporting incorrect content or code samples)

No response

[KTrain5169]

As far as I remember, wrangler configuration is optional, unless you need to use bindings/environments/some other stuff (the reason why is because wrangler would then need to generate worker types for your bindings, so you can get type hints in your IDE)

[KTrain5169]

taking a second look at Cloudflare's page, the page is very out-of-date, as it still says Astro 6 is in beta.
So Cloudflare's guide probably needs a patch or two, if not a rewrite

[ArmandPhilippot]

Yes, as KTrain said, the configuration file is optional, and the Cloudflare guide for Astro seems outdated. So, you should follow our migration guide, and if necessary, the Cloudflare migration guide from Pages to Worker, but not their Astro guide.

I'm going to close this issue as I don't see anything actionable in the docs repo. But, feel free to report the outdated content to Cloudflare!

Thanks for the help, KTrain!