Add better documentation for working with cloudflare workers

[NickMous]

Hiya!

I have been stuck for a long time on working with actions and cloudflare. Finally, I have everything working. But or I am reading really badly, or the docs aren't there, because I was missing alot of important configuration.

Such as
In the astro docs, the wrangler.jsonc config isn't there, and is mandatory. While I had that, in the cloudflare docs they didn't mention the "main" entry as needed, and "compatibility_flags" was also needed in order for wrangler to use node built-ins.

To prevent the next person from running into this, I suggest adding this kind of info. If needed, I can contribute and improve the docs.

[sarah11918]

Thanks for letting us know, and sorry you're had trouble putting things together! It can be challenging for us to document with third-party services because we mostly focus on the "getting the two connected" part, and have to rely on e.g. Cloudflare for details on their config, implementation etc.

So, while we wouldn't necessarily for example show how to config wrangler.jsonc in general, if there's a special config section required for Astro (or a feature like Actions) to work, then we would typically have a step to say "configure this" and I would expect us to show it. (But we could only really show a minimal/generic config because we might not be able to know what else someone might need for other aspects of their project.) So it gets really context-dependent and there can be a chance that we miss something, or that there's something that might already be assumed to be configured for something to work at all that we wouldn't necessarily have addressed!

I'll loop @alexanderniebuhr in on this at least, and maybe the two of you could discuss here what's missing from our docs, and from where (the Actions page? The Cloudflare adapter page?) so that we can figure out which information we might need to add and put it in the spot where people are looking for it!

[alexanderniebuhr]

@NickMous Thanks for that. I agree we don't have everything documented yet, but as @sarah11918 said not everything is needed typically. E.g. wrangler.[jsonc,toml] with the configuration options you mentioned is only needed if you deploy to Cloudflare Workers, if you deploy to Cloudflare Pages, those are not needed at all. Our docs don't make a difference so far. I'd suggest that you propose a new section similar to the one we have for Sessions, which talks about Actions and what is needed for them to work for both Cloudflare Workers and Cloudflare Pages, happy to help you with reviewing a PR.