Worker Previews docs: restructure resources, update cross-references - #31775
Open
yomna-shousha wants to merge 31 commits into
Open
yomna-shousha wants to merge 31 commits into
yomna-shousha wants to merge 31 commits into
Conversation
yomna-shousha
requested review from
a team,
GregBrimble,
MattieTK,
WalshyDev,
aninibread,
ericclemmons,
irvinebroque,
kodster28,
korinne and
vy-ton
as code owners
June 29, 2026 15:25
This comment was marked as outdated.
This comment was marked as outdated.
Contributor
|
This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:
|
github-actions
Bot
assigned
GregBrimble,
irvinebroque,
MattieTK,
vy-ton,
WalshyDev,
kodster28,
aninibread and
ericclemmons
Contributor
|
This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:
|
Contributor
|
I have completed my review of PR #31775. My findings are summarized above in the review. Here's a quick recap of what needs maintainer attention:
Everything else looks solid: redirects are in place, MDX syntax is clean, component imports and image paths are correct, and the cross-reference updates are comprehensive. |
This comment was marked as outdated.
This comment was marked as outdated.
- Fix Access link: /cloudflare-one/policies/access/ → /cloudflare-one/access-controls/policies/ - Fix placement link: /workers/configuration/smart-placement/ → /workers/configuration/placement/ - Add missing redirect for deleted /workers/previews/troubleshooting/
…fig push - preview secret put/delete/list/bulk: --name now optional (defaults to git branch) - Added --message and --tag flags to put, delete, and bulk - Updated descriptions to reflect per-deployment patching behavior - preview secret bulk: documented FILE positional arg and null value deletion - preview secret list: noted it reads from latest Preview deployment - Fixed bindings.mdx typo: 'preview base secret put' → 'preview base-config secret put' - Updated recipes.mdx migration table with --name flag - Removed preview base-config push command (not shipping)
…uth for Preview settings
- Rewrite get-started page: cut redundancy, add Steps/DashButton, 3 deploy tabs - Tighten overview: remove isolation matrix from top, simplify limits/URLs - Simplify configuration: shorten callout, collapse repeated wrangler-applies section - Clean up resources: merge bullet list into matrix, remove duplicated sections - Restructure custom-domains: tabs for Dashboard/Wrangler/API, workers.dev toggle steps, Enable for options with screenshots - Add dashboard screenshots (pending rendering verification in prod) - CI/CD page unchanged (already clean)
…, simplify deploy steps
…ig, remove dashboard overlap, add wrangler envs example
yomna-shousha
force-pushed
the
worker-previews-docs-2
branch
from
September 17, 2026 22:19
4583673 to
a080e74
Compare
mvvmm
reviewed
Sep 18, 2026
Co-authored-by: mvvmm <mvvmm@users.noreply.github.com>
Contributor
|
Agreed — these five components are page-specific (each used on exactly one page), so they belong as direct imports, not in the The repo's documented convention ( Changes made:
Validation: |
Open
5 tasks
mvvmm
approved these changes
Sep 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
12 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this PR does
Restructures and expands the Worker Previews documentation.
Changes
New pages:
previews/recipes.mdx— static how-tos: PR preview per branch, persistent staging, data isolation, monorepo, migration from Wrangler environments, API-managed previewspreviews/resources/index.mdx— overview of resource sharing and isolationpreviews/resources/bindings.mdx— per-binding reference with config snippetspreviews/resources/durable-objects.mdx— DO and Containers isolation detailsNew components:
PreviewsConfigDiagram.astro— base configuration diagramPreviewsResourcesDiagram.astro— resource sharing diagramRestructured:
resources.mdxintoresources/directory (index, bindings, durable-objects)previews/commands.mdx→wrangler/commands/workers.mdxUpdated cross-references:
Deleted:
commands.mdx(content moved to wrangler commands)resources.mdx(split into resources/ directory)troubleshooting.mdx(content folded into other pages)Normalized: "Worker Previews" → "Previews" across referenced pages
Not included (separate commits)
Known issues to fix later
/workers/configuration/cloudflare-access/link in index.mdx needs correct path