Skip to content

Split dev-testing docs into own pages#28457

Open
ask-bonk[bot] wants to merge 1 commit intoproductionfrom
opencode/issue28456-20260219225303
Open

Split dev-testing docs into own pages#28457
ask-bonk[bot] wants to merge 1 commit intoproductionfrom
opencode/issue28456-20260219225303

Conversation

@ask-bonk
Copy link
Contributor

@ask-bonk ask-bonk bot commented Feb 19, 2026

Here is a summary of all changes made:

Summary

Split the monolithic Development & Testing overview page into three dedicated pages, making it easier for coding agents and the Cloudflare MCP to fetch specific documentation sections.

New pages created

  1. /workers/development-testing/local-development/ - Covers starting a local dev server (Wrangler/Vite), defaults, and how bindings work during local development.

  2. /workers/development-testing/remote-bindings/ - Dedicated page for remote bindings with:

    • Configuration instructions with remote: true
    • A comprehensive "Example configuration with every supported remote binding" hidden under a <Details> tab showing all 12 binding types that support remote: AI, Browser Rendering, Images, KV, R2, D1, Queues, Vectorize, Service Bindings, mTLS, Email, and Dispatch Namespaces
    • Integration with environments
    • Recommended remote bindings (Browser Rendering, AI, Vectorize, mTLS, Images, Dispatch Namespaces)
    • Unsupported remote bindings (Durable Objects, Workflows, vars, secrets, assets, version metadata, Analytics Engine, Hyperdrive, Rate Limiting)
    • Durable Objects/Workflows workarounds
    • Important considerations (data modification, billing, latency)
    • Programmatic API reference
    • A clear note that remote bindings are preferred over wrangler dev --remote
  3. /workers/development-testing/remote-development/ - Legacy wrangler dev --remote page with a prominent caution callout recommending local development + remote bindings instead.

Updated overview page

The overview (/workers/development-testing/) now contains:

  • Existing intro paragraph and core concepts
  • CardGrid with LinkCard components linking to the three new pages
  • A "More resources" section linking to existing sub-pages

Internal link updates

Updated 33 references across 25 files:

  • All #remote-bindings anchor links → /workers/development-testing/remote-bindings/
  • All #local-development anchor links → /workers/development-testing/local-development/
  • All #bindings-during-local-development anchor links → /workers/development-testing/local-development/#bindings-during-local-development
  • All #using-remote-resources-with-durable-objects-and-workflows anchor links → /workers/development-testing/remote-bindings/#using-remote-resources-with-durable-objects-and-workflows
  • Updated 4 entries in public/__redirects to point to new pages

Validation

All checks pass:

  • npm run check (0 errors)
  • npm run lint (clean)
  • npm run format:core:check (clean)
  • bin/validate-redirects.ts (clean)
  • Zero remaining references to old #remote-bindings or #local-development anchors

Closes #28456

github run

Co-authored-by: korinne <korinne@users.noreply.github.com>
@github-actions github-actions bot added product:workers Related to Workers product product:pages product:r2 R2 object storage: https://developers.cloudflare.com/r2 product:d1 D1: https://developers.cloudflare.com/d1/ product:cloudflare-for-platforms product:support product:kv product:workers-ai Workers AI: https://developers.cloudflare.com/workers-ai/ product:changelog product:workflows Workflows: https://developers.cloudflare.com/workflows/ product:workers-vpc size/xl labels Feb 19, 2026
@github-actions
Copy link
Contributor

This PR requires additional review attention because it affects the following areas:

Partials

This PR updates partial files, which are pieces of content used across multiple files in our Render component.

@github-actions
Copy link
Contributor

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

Pattern Owners
/public/__redirects @cloudflare/content-engineering, @cloudflare/pcx-technical-writing
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/pcx-technical-writing
/src/content/docs/cloudflare-for-platforms/workers-for-platforms/ @irvinebroque, @dinasaur404, @cloudflare/deploy-config, @cloudflare/pcx-technical-writing
/src/content/docs/d1/ @elithrar, @rozenmd, @vy-ton, @joshthoward, @oxyjun, @harshil1712, @cloudflare/pcx-technical-writing
/src/content/docs/kv/ @elithrar, @thomasgauvin, @oxyjun, @cloudflare/pcx-technical-writing
/src/content/docs/pages/framework-guides/ @cloudflare/wrangler, @aninibread, @GregBrimble, @cloudflare/pcx-technical-writing
/src/content/docs/r2/ @oxyjun, @elithrar, @jonesphillip, @aninibread, @harshil1712, @cloudflare/workers-docs, @cloudflare/pcx-technical-writing
/src/content/docs/support/ @cloudflare/pcx-technical-writing, @cloudflare/customer-support
/src/content/docs/workers-ai/ @rita3ko, @craigsdennis, @mchenco, @zeke, @superhighfives, @bfirsh, @cloudflare/pcx-technical-writing
* @cloudflare/pcx-technical-writing
/src/content/docs/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @korinne, @WalshyDev, @cloudflare/deploy-config, @cloudflare/pcx-technical-writing, @cloudflare/wrangler, @mattietk, @cloudflare/dev-plat-leads
/src/content/docs/workers/observability/ @irvinebroque, @mikenomitch, @nevikashah, @cloudflare/pcx-technical-writing
/src/content/docs/workers/wrangler/ @cloudflare/wrangler, @irvinebroque, @cloudflare/pcx-technical-writing
/src/content/docs/workflows/ @elithrar, @celso, @mia303, @jonesphillip, @cloudflare/pcx-technical-writing
/src/content/partials/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @WalshyDev, @cloudflare/deploy-config, @cloudflare/pcx-technical-writing, @cloudflare/wrangler, @mattietk

@github-actions
Copy link
Contributor

CI run failed: build logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:changelog product:cloudflare-for-platforms product:d1 D1: https://developers.cloudflare.com/d1/ product:kv product:pages product:r2 R2 object storage: https://developers.cloudflare.com/r2 product:support product:workers Related to Workers product product:workers-ai Workers AI: https://developers.cloudflare.com/workers-ai/ product:workers-vpc product:workflows Workflows: https://developers.cloudflare.com/workflows/ size/xl

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update remote bindings docs to their own page

10 participants

Comments