Skip to content

[Images] Update binding docs for hosted images#31349

Open
deannalam wants to merge 4 commits into
productionfrom
deanna/hosted-bindings
Open

[Images] Update binding docs for hosted images#31349
deannalam wants to merge 4 commits into
productionfrom
deanna/hosted-bindings

Conversation

@deannalam

Copy link
Copy Markdown
Contributor

Summary

  • Adds documentation for managing hosted images with the Images binding
  • Updates links

Changes

Structural changes

  • Optimization section:
    • Moves Images binding page one level up from under "Remote images (transformations)" to "Optimization"

New pages

  • Manage with Workers: Using the Images binding to manage hosted images

Updated content

  • Renamed Transform via Workers to Transform via fetch to distinguish from binding page.
  • Updated files across other documentation to point to the new binding path.
  • Added a redirect from the old binding page.

@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Review

⏸️ Automatic reviews for this PR are paused.

This PR has already received 2 automatic reviews. To run another review, a codeowner can comment /review or /full-review.

Tip: Keep PRs in draft mode until they are ready for review — the bot skips draft PRs automatically.


✅ No style-guide issues found in commit 3b15cb7.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.

@github-actions github-actions Bot added product:workers Related to Workers product product:stream Related to Stream product product:images Related to Image Resizing product product:china-network product:changelog size/l labels Jun 9, 2026
@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown
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/product-owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/product-owners
/src/content/docs/china-network/ @pedrosousa, @cloudflare/appsec-reviewers, @elithrar, @cloudflare/product-owners
/src/content/docs/images/ @dcpena, @cloudflare/product-owners, @renandincer, @third774
/src/content/docs/stream/ @tsmith512, @dcpena, @cloudflare/product-owners, @renandincer, @third774
/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/static-assets @irvinebroque, @GregBrimble, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners, @MattieTK, @vy-ton

@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

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

Redirects

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

  • /images/optimization/transformations/bindings/

@ask-bonk ask-bonk Bot added documentation Documentation edits content:new Request for new/missing content labels Jun 9, 2026

@ask-bonk ask-bonk Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few style issues to fix in the new binding pages. The structural changes, redirects, and link updates look correct.

Comment thread src/content/docs/images/optimization/binding.mdx Outdated
Comment thread src/content/docs/images/optimization/binding.mdx Outdated
Comment thread src/content/docs/images/optimization/binding.mdx Outdated
Comment thread src/content/docs/images/optimization/binding.mdx Outdated
Comment thread src/content/docs/images/optimization/binding.mdx Outdated
Comment thread src/content/docs/images/storage/binding.mdx Outdated
@ask-bonk

ask-bonk Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Review complete. Applied labels documentation, product:images, product:workers, and content:new. Posted 6 inline suggestions.

Issues

  • LOWsrc/content/docs/images/optimization/binding.mdx: The .draw() example uses inconsistent spacing (missing spaces after commas and around braces/colons). Suggested fixes at lines 147, 152, 159, 160, and 162.
  • LOWsrc/content/docs/images/storage/binding.mdx: Trailing whitespace on line 100 in the .update() options list.

What passes

  • Redirects are correctly set up (/images/optimization/transformations/bindings//images/optimization/binding/).
  • All cross-page links are updated to the new path and anchors resolve correctly.
  • New pages use required frontmatter (title, description, pcx_content_type).
  • TypeScriptExample and WranglerConfig components are used appropriately.
  • The structural split between optimization binding (images/optimization/binding/) and hosted-image management binding (images/storage/binding/) is clear and well-scoped.

No critical or high-severity issues. The PR is ready to merge after addressing the minor style fixes.

github run

@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Preview URL: https://55bb6747.preview.developers.cloudflare.com
Preview Branch URL: https://deanna-hosted-bindings.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/images/storage/binding/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/images/storage/binding/
https://developers.cloudflare.com/images/optimization/binding/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/images/optimization/binding/
https://developers.cloudflare.com/images/optimization/transformations/bindings/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/images/optimization/transformations/bindings/
https://developers.cloudflare.com/images/optimization/transformations/transform-via-workers/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/images/optimization/transformations/transform-via-workers/
https://developers.cloudflare.com/images/pricing/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/images/pricing/
https://developers.cloudflare.com/workers/observability/traces/spans-and-attributes/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/workers/observability/traces/spans-and-attributes/
https://developers.cloudflare.com/changelog/post/2025-02-21-images-bindings-in-workers/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/changelog/post/2025-02-21-images-bindings-in-workers/
https://developers.cloudflare.com/china-network/reference/available-products/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/china-network/reference/available-products/
https://developers.cloudflare.com/images/optimization/transformations/draw-overlays/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/images/optimization/transformations/draw-overlays/
https://developers.cloudflare.com/images/storage/manage-images/delete-images/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/images/storage/manage-images/delete-images/
https://developers.cloudflare.com/images/tutorials/optimize-user-uploaded-image/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/images/tutorials/optimize-user-uploaded-image/
https://developers.cloudflare.com/stream/transform-videos/bindings/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/stream/transform-videos/bindings/
https://developers.cloudflare.com/workers/development-testing/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/workers/development-testing/
https://developers.cloudflare.com/workers/reference/migrate-to-module-workers/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/workers/reference/migrate-to-module-workers/
https://developers.cloudflare.com/workers/runtime-apis/bindings/images/ https://deanna-hosted-bindings.preview.developers.cloudflare.com/workers/runtime-apis/bindings/images/

Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
@mvvmm

mvvmm commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

/full-review

@deannalam deannalam requested a review from mglewis June 9, 2026 17:24
@deannalam deannalam changed the title [Images] Restructure binding docs for hosted images and optimization [Images] Update binding docs for hosted images Jun 9, 2026
@deannalam deannalam removed the request for review from mglewis June 9, 2026 22:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content:new Request for new/missing content documentation Documentation edits product:changelog product:china-network product:images Related to Image Resizing product product:stream Related to Stream product product:workers Related to Workers product size/l

Projects

None yet

Development

Successfully merging this pull request may close these issues.