workflows: new docs

[elithrar]

DO NOT MERGE

This PR documents the new waitForEvent API in Workflows and other minor changes:

• remove beta badge
• update the Workflows starter: wait for event workflows-starter#6
• pricing
• document sendEvent at https://developers.cloudflare.com/workflows/build/workers-api/
• add waitForEvent to https://developers.cloudflare.com/workflows/build/workers-api/
• changelog entry
• update events docs at https://developers.cloudflare.com/workflows/build/events-and-parameters/

Later

• update Rules of Workflows to talk about best practices - https://developers.cloudflare.com/workflows/build/rules-of-workflows/ - “workflows are just code” + p-map

[hyperlint-ai]

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

Documented the new waitForEvent API in Workflows and made several updates to existing documentation.

• Added documentation for the waitForEvent API in Workflows.
• Updated events documentation to include new ways to pass parameters.
• Introduced a human-in-the-loop concept with examples.
• Updated best practices in the Rules of Workflows.

Modified Files

• src/content/docs/workflows/build/events-and-parameters.mdx

Added Files

• src/content/changelog/workflows/2025-04-07-workflows-human-in-the-loop copy.mdx
• src/content/changelog/workflows/2025-04-07-workflows-human-in-the-loop.mdx
• src/content/docs/workflows/build/human-in-the-loop.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]

Preview URL: https://ac5ab122.preview.developers.cloudflare.com
Preview Branch URL: https://workflows-waitforevent.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/workflows/build/events-and-parameters/	https://workflows-waitforevent.preview.developers.cloudflare.com/workflows/build/events-and-parameters/
https://developers.cloudflare.com/changelog/2025-04-07-workflows-ga/	https://workflows-waitforevent.preview.developers.cloudflare.com/changelog/2025-04-07-workflows-ga/
https://developers.cloudflare.com/workflows/build/workers-api/	https://workflows-waitforevent.preview.developers.cloudflare.com/workflows/build/workers-api/
https://developers.cloudflare.com/workflows/reference/pricing/	https://workflows-waitforevent.preview.developers.cloudflare.com/workflows/reference/pricing/
https://developers.cloudflare.com/workflows/reference/limits/	https://workflows-waitforevent.preview.developers.cloudflare.com/workflows/reference/limits/
https://developers.cloudflare.com/workflows/get-started/cli-quick-start/	https://workflows-waitforevent.preview.developers.cloudflare.com/workflows/get-started/cli-quick-start/
https://developers.cloudflare.com/workflows/get-started/guide/	https://workflows-waitforevent.preview.developers.cloudflare.com/workflows/get-started/guide/
https://developers.cloudflare.com/workflows/	https://workflows-waitforevent.preview.developers.cloudflare.com/workflows/