Skip to content

[AI Gateway] Move worker binding methods to Using AI Gateway section#31403

Open
ethulia wants to merge 2 commits into
productionfrom
ml/move-binding-methods-to-usage
Open

[AI Gateway] Move worker binding methods to Using AI Gateway section#31403
ethulia wants to merge 2 commits into
productionfrom
ml/move-binding-methods-to-usage

Conversation

@ethulia

@ethulia ethulia commented Jun 11, 2026

Copy link
Copy Markdown
Collaborator

Summary

Move worker binding methods to Using AI Gateway section

Screenshots (optional)

Documentation checklist

  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Review

✅ No style-guide issues found in commit 84a3659.

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:ai-gateway AI Gateway: https://developers.cloudflare.com/ai-gateway/ product:changelog size/s labels Jun 11, 2026
@github-actions

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:

  • /ai-gateway/integrations/worker-binding-methods/

@github-actions

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/ai-gateway/ @abhishekkankani, @palashgo, @thebongy, @roerohan, @kathayl, @mchenco, @zeke, @superhighfives, @bfirsh, @mattrothenberg, @ethulia, @aninibread, @kflansburg, @cloudflare/product-owners

@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.

Summary

This PR cleanly moves the Workers Bindings reference from the Integrations section to the Using AI Gateway section. All internal links are updated and a redirect is in place — good attention to avoiding broken links.

Issues to address

1. Sidebar order collision in usage/ directory ⚠️

src/content/docs/ai-gateway/usage/worker-binding-methods.mdx still has:

sidebar:
  order: 1

However, src/content/docs/ai-gateway/usage/rest-api.mdx also has sidebar.order: 1. Having duplicate orders in the same directory produces ambiguous sidebar ordering in Starlight.

Suggestion: Update the moved file to a unique order. The existing files in usage/ currently use orders 1, 2, and 3 (index), so setting the moved file to order: 4 (or reordering the section intentionally) would resolve the collision.

2. Empty PR description 📝

The PR body contains only the unchecked template. Please add a short description explaining the rationale for the move (for example, why this content fits better under Usage than Integrations).

3. Changelog

No new changelog entry is required for a pure reorganization, but make sure the checklist in the PR description is intentionally filled out rather than left blank.

Labels

  • product:ai-gateway — appropriate
  • size/s — accurate
  • product:changelog — accurate because a historical changelog link is updated

No additional labels needed.

@ask-bonk

ask-bonk Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Posted a request-changes review on PR #31403.

What the PR does
Moves the Workers Bindings reference page from /ai-gateway/integrations/worker-binding-methods/ to /ai-gateway/usage/worker-binding-methods/, updates all internal links (5 files + 1 changelog entry), and adds a 301 redirect.

Labels
Already correctly labeled (product:ai-gateway, size/s, product:changelog). No changes needed.

Issues flagged

  1. Sidebar order collisionusage/worker-binding-methods.mdx keeps its old sidebar.order: 1, but usage/rest-api.mdx already has order: 1. Duplicate orders in the same Starlight directory cause ambiguous sidebar ordering. Suggested updating the moved file to a unique order (e.g., 4).
  2. Empty PR description — The body is just the unchecked template. Suggested adding a brief rationale for the move.
  3. Changelog checklist — Noted that a new changelog entry isn't strictly required for a pure reorganization, but the checklist should be intentionally addressed rather than left blank.

github run

@github-actions

github-actions Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Preview URL: https://84a36591.preview.developers.cloudflare.com
Preview Branch URL: https://ml-move-binding-methods-to-usage.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/changelog/post/2025-01-26-worker-binding-methods/ https://ml-move-binding-methods-to-usage.preview.developers.cloudflare.com/changelog/post/2025-01-26-worker-binding-methods/
https://developers.cloudflare.com/ai-gateway/evaluations/add-human-feedback-bindings/ https://ml-move-binding-methods-to-usage.preview.developers.cloudflare.com/ai-gateway/evaluations/add-human-feedback-bindings/
https://developers.cloudflare.com/ai-gateway/features/unified-billing/ https://ml-move-binding-methods-to-usage.preview.developers.cloudflare.com/ai-gateway/features/unified-billing/
https://developers.cloudflare.com/ai-gateway/integrations/aig-workers-ai-binding/ https://ml-move-binding-methods-to-usage.preview.developers.cloudflare.com/ai-gateway/integrations/aig-workers-ai-binding/
https://developers.cloudflare.com/ai-gateway/usage/chat-completion/ https://ml-move-binding-methods-to-usage.preview.developers.cloudflare.com/ai-gateway/usage/chat-completion/
https://developers.cloudflare.com/ai-gateway/usage/rest-api/ https://ml-move-binding-methods-to-usage.preview.developers.cloudflare.com/ai-gateway/usage/rest-api/
https://developers.cloudflare.com/ai-gateway/usage/websockets-api/ https://ml-move-binding-methods-to-usage.preview.developers.cloudflare.com/ai-gateway/usage/websockets-api/
https://developers.cloudflare.com/ai-gateway/usage/worker-binding-methods/ https://ml-move-binding-methods-to-usage.preview.developers.cloudflare.com/ai-gateway/usage/worker-binding-methods/

@ethulia

ethulia commented Jun 11, 2026

Copy link
Copy Markdown
Collaborator Author

/bonk review this

@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.

Summary

Code changes look correct. The redirect, internal link updates, and sidebar re-ordering are all in place.

One remaining issue

Empty PR description — The PR body is still the unchecked template. Please add a brief rationale for moving the Workers Bindings page from Integrations to Usage.

@ask-bonk

ask-bonk Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Posted a review on PR #31403.

What I checked

  • Redirect addition: correctly covers the old path with a 301
  • Internal link updates: 6 files + 1 changelog entry all point to the new location
  • Sidebar ordering: the collision with rest-api.mdx was fixed in the follow-up commit; the remaining duplicate order (2) is with universal.mdx, which is hidden: true and therefore doesn't affect the visible sidebar
  • MDX syntax and frontmatter: no build-breaking issues

What remains

  • The PR description is still the empty template — noted in the review comment

github run

@ethulia

ethulia commented Jun 12, 2026

Copy link
Copy Markdown
Collaborator Author

/bonk review this

@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.

Summary

Code changes are correct. The file move, redirect, internal link updates, and sidebar re-ordering are all properly handled.

One remaining issue

PR description — The body is still the unchecked template. Please add a brief rationale for moving the Workers Bindings page from Integrations to Usage (for example, why this content fits better under Usage). This was previously flagged and remains unaddressed.

@ask-bonk

ask-bonk Bot commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Posted a review on PR #31403.

What I checked

  • File move: worker-binding-methods.mdx correctly moved from integrations/ to usage/
  • Redirect: 301 redirect properly added in public/__redirects
  • Internal links: all 6 docs files + 1 changelog entry updated to the new path
  • Sidebar ordering: rest-api (1), worker-binding-methods (2), chat-completion (3), websockets-api (5) — no visible collisions; the duplicate order: 2 with universal.mdx is harmless since that file is hidden: true
  • No remaining references to the old path anywhere in the repo

What I flagged

  • PR description — Still the empty unchecked template. This is the only remaining item; it was flagged in two prior reviews and remains unaddressed. A brief rationale for the move would be helpful.

github run

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

Labels

product:ai-gateway AI Gateway: https://developers.cloudflare.com/ai-gateway/ product:changelog size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.