WFP convergence [WIP - do not merge] by dinasaur404 · Pull Request #31838 · cloudflare/cloudflare-docs

dinasaur404 · 2026-07-01T20:23:15Z

Summary

Restructures the Workers for Platforms documentation to better reflect the product's current architecture and terminology. Key changes:

New sections: Inbound control (hostname routing, cron triggers, queue consumers, previews), outbound control, and versioning (versions, rollouts, rollbacks, version affinity)
Moved pages: platform-templates/ → examples/, dynamic-dispatch and hostname-routing → inbound-control/, outbound-workers → outbound-control
New component: WorkersForPlatformsVersioningDiagram
Updated all cross-references across the docs (reference architectures, Workers bindings, wrangler config, etc.) to point to new locations
Added redirects for all moved/deleted pages

Documentation checklist

The change adheres to the documentation style guide.
Files which have changed name or location have been allocated redirects.

github-actions · 2026-07-01T20:23:38Z

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

/cloudflare-for-platforms/workers-for-platforms/configuration/dynamic-dispatch/
/cloudflare-for-platforms/workers-for-platforms/configuration/hostname-routing/
/cloudflare-for-platforms/workers-for-platforms/configuration/outbound-workers/
/cloudflare-for-platforms/workers-for-platforms/platform-templates/platform-starter-kit/
/cloudflare-for-platforms/workers-for-platforms/platform-templates/vibesdk/
/cloudflare-for-platforms/workers-for-platforms/platform-templates/

github-actions · 2026-07-01T20:24:08Z

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
`/public/__redirects`	`@cloudflare/content-engineering`, `@cloudflare/product-owners`
`*.astro`	`@cloudflare/content-engineering`, `@kodster28`
`*.ts`	`@cloudflare/content-engineering`, `@kodster28`
`/src/content/docs/cloudflare-for-platforms/cloudflare-for-saas/`	`@baubuchon-cf`, `@irvinebroque`, `@dinasaur404`, `@cloudflare/appsec-reviewers`, `@elithrar`, `@cloudflare/product-owners`
`/src/content/docs/cloudflare-for-platforms/`	`@irvinebroque`, `@dinasaur404`, `@cloudflare/product-owners`
`/src/content/docs/cloudflare-for-platforms/workers-for-platforms/`	`@irvinebroque`, `@dinasaur404`, `@cloudflare/deploy-config`, `@cloudflare/product-owners`
`/src/content/docs/reference-architecture/`	`@securitypedant`, `@cloudflare/product-owners`, `@ncrouch-cflare`
`*`	`@cloudflare/product-owners`
`/src/content/docs/workers/`	`@cloudflare/workers-docs`, `@GregBrimble`, `@irvinebroque`, `@mikenomitch`, `@korinne`, `@WalshyDev`, `@cloudflare/deploy-config`, `@cloudflare/product-owners`, `@cloudflare/wrangler`, `@MattieTK`, `@cloudflare/dev-plat-leads`, `@vy-ton`
`/src/content/docs/workers/observability/`	`@irvinebroque`, `@mikenomitch`, `@nevikashah`, `@cloudflare/product-owners`, `@vy-ton`
`/src/content/docs/workers/wrangler/`	`@cloudflare/wrangler`, `@irvinebroque`, `@cloudflare/product-owners`, `@MattieTK`, `@vy-ton`

ask-bonk · 2026-07-01T20:29:58Z

Review of PR #31838 — WFP convergence

Thanks for this restructure! The new organization is much clearer. Overall the changes are solid, but there are a few issues that need fixing before merge.

Summary of changes

New sections: Inbound control (inbound-control/), outbound control (outbound-control.mdx), and versioning (versioning/) with 10 new pages total.
Moved pages: platform-templates/ → examples/, dynamic-dispatch + hostname-routing → inbound-control/, outbound-workers → outbound-control.
New component: WorkersForPlatformsVersioningDiagram — an Astro/SVG diagram used on the versioning overview.
Updated cross-references: ~10 files across Workers bindings, wrangler config, reference architecture, and tail-workers docs updated to point to new locations.
Redirects: 8 redirects added to public/__redirects covering all moved/deleted paths.

Labels to apply

documentation
cloudflare-for-platforms

Issues requiring maintainer attention

1. Broken internal links in unchanged file `enterprise-ai-vibe-coding-platform.mdx`

This file still references the deleted pages. These links will 404 unless updated:

Line 73: [dispatch worker](/cloudflare-for-platforms/workers-for-platforms/configuration/dynamic-dispatch/)
Should be: /cloudflare-for-platforms/workers-for-platforms/inbound-control/hostname-routing/
Line 75: [outbound worker](/cloudflare-for-platforms/workers-for-platforms/configuration/outbound-workers/)
Should be: /cloudflare-for-platforms/workers-for-platforms/outbound-control/

This file is not in the PR diff, so it was missed during the bulk find-and-replace.

2. Broken anchor link: `rollout.mdx` line 43

Your platform needs to store the version IDs returned when you [create versions](/cloudflare-for-platforms/workers-for-platforms/versioning/versions/#upload-a-version).

The heading in versions.mdx is ## Create a version, so the correct anchor is #create-a-version.

Suggested fix:

Your platform needs to store the version IDs returned when you [create versions](/cloudflare-for-platforms/workers-for-platforms/versioning/versions/#create-a-version).

3. Broken anchor link: `version-affinity.mdx` line 188

Refer to [Versions](/cloudflare-for-platforms/workers-for-platforms/versioning/versions/#test-a-version) for the full setup.

The heading in versions.mdx is ## Send test requests to the new version, so the correct anchor is #send-test-requests-to-the-new-version.

Suggested fix:

Refer to [Versions](/cloudflare-for-platforms/workers-for-platforms/versioning/versions/#send-test-requests-to-the-new-version) for the full setup.

4. Redirects status check

The gh-actions bot flagged 6 paths as needing redirects. The diff shows 8 redirects were added, which covers all 6 flagged paths plus the additional legacy paths /configuration/inbound-workers/ and /configuration/custom-binding/. ✅

However, the bot's checkboxes are still unchecked in the PR comments — you may want to tick them after confirming.

Minor observations (non-blocking)

Component naming: WorkersForPlatformsVersioningDiagram is clean and follows the existing PascalCase convention in src/components/index.ts.
Frontmatter: All new pages have required fields (title, pcx_content_type, description, sidebar.order). Descriptions are within the 50–160 character range.
Code samples: The jsonc and js language tags are correct. No unescaped { < characters found in prose.
Accessibility: The new diagram component includes aria-label on the figure and sections, and aria-hidden="true" on the decorative SVG. Good.

Action items before merge

Update the two broken anchor links in rollout.mdx and version-affinity.mdx.
Update the two stale links in enterprise-ai-vibe-coding-platform.mdx.
Run pnpm run check and pnpm run format:core:check (CI will catch anything else).

github run

github-actions · 2026-07-01T20:45:19Z

CI run failed: build logs

github-actions · 2026-07-01T20:45:22Z

Broken Links

Found 4 broken link(s) across 3 file(s).

File	Link	Position	Error
`content/compatibility-flags/dynamic-dispatch-tunnel-exceptions.md`	`/cloudflare-for-platforms/workers-for-platforms/configuration/dynamic-dispatch/`	`14:47`	invalid link
`content/changelog/workers-for-platforms/2025-12-18-dashboard-improvements.mdx`	`/cloudflare-for-platforms/workers-for-platforms/configuration/dynamic-dispatch/`	`18:172`	invalid link
`reference-architecture/diagrams/ai/enterprise-ai-vibe-coding-platform.mdx`	`/cloudflare-for-platforms/workers-for-platforms/configuration/dynamic-dispatch/`	`73:304`	invalid link
`reference-architecture/diagrams/ai/enterprise-ai-vibe-coding-platform.mdx`	`/cloudflare-for-platforms/workers-for-platforms/configuration/outbound-workers/`	`75:65`	invalid link

github-actions · 2026-07-01T20:50:13Z

Preview URL: https://529d86bf.preview.developers.cloudflare.com
Preview Branch URL: https://wfp-custom-bindings-docs.preview.developers.cloudflare.com

Files with changes (up to 15)

irvinebroque

nice!

[WFP] Workers for Platforms docs convergence

529d86b

github-actions Bot added product:workers Related to Workers product product:reference-architecture product:cloudflare-for-platforms product:use-cases size/xl labels Jul 1, 2026

github-actions Bot assigned kodster28, baubuchon-cf, elithrar, irvinebroque, ncrouch-cflare, securitypedant, GregBrimble, korinne, MattieTK and vy-ton Jul 1, 2026

dinasaur404 changed the title ~~WFP convergence~~ WFP convergence [WIP - do not merge] Jul 1, 2026

irvinebroque reviewed Jul 1, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

WFP convergence [WIP - do not merge]#31838

WFP convergence [WIP - do not merge]#31838
dinasaur404 wants to merge 1 commit into
productionfrom
wfp-custom-bindings-docs

dinasaur404 commented Jul 1, 2026

Uh oh!

github-actions Bot commented Jul 1, 2026

Uh oh!

github-actions Bot commented Jul 1, 2026

Uh oh!

ask-bonk Bot commented Jul 1, 2026

Uh oh!

github-actions Bot commented Jul 1, 2026

Uh oh!

github-actions Bot commented Jul 1, 2026

Uh oh!

github-actions Bot commented Jul 1, 2026

Uh oh!

irvinebroque left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

11 participants

Uh oh!

Conversation

dinasaur404 commented Jul 1, 2026

Summary

Documentation checklist

Uh oh!

github-actions Bot commented Jul 1, 2026

Uh oh!

github-actions Bot commented Jul 1, 2026

Uh oh!

ask-bonk Bot commented Jul 1, 2026

Review of PR #31838 — WFP convergence

Summary of changes

Labels to apply

Issues requiring maintainer attention

1. Broken internal links in unchanged file enterprise-ai-vibe-coding-platform.mdx

2. Broken anchor link: rollout.mdx line 43

3. Broken anchor link: version-affinity.mdx line 188

4. Redirects status check

Minor observations (non-blocking)

Action items before merge

Uh oh!

github-actions Bot commented Jul 1, 2026

Uh oh!

github-actions Bot commented Jul 1, 2026

Broken Links

Uh oh!

github-actions Bot commented Jul 1, 2026

Uh oh!

irvinebroque left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

11 participants

1. Broken internal links in unchanged file `enterprise-ai-vibe-coding-platform.mdx`

2. Broken anchor link: `rollout.mdx` line 43

3. Broken anchor link: `version-affinity.mdx` line 188