[Workers AI] Add Model Deprecations reference page with redirects

[mchenco]

Summary

• Add deprecation data source (src/util/deprecated-models.ts)
• Add reference page listing deprecated and planned-deprecation models (src/content/docs/workers-ai/platform/model-deprecations.mdx)
• Add reusable content component (src/components/models/DeprecatedModelPage.astro)
• Add deprecation banner on planned-deprecation model pages (src/components/models/ModelDetailPage.astro)
• Redirect deprecated model URLs to reference page (public/__redirects)

Screenshots (optional)

Documentation checklist

• Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
• 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.

[github-actions]

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
/src/content/docs/workers-ai/	@rita3ko, @craigsdennis, @mchenco, @zeke, @superhighfives, @bfirsh, @mattrothenberg, @ethulia, @cloudflare/product-owners
*.ts	@cloudflare/content-engineering, @kodster28

[ask-bonk]

Labels applied: , , .

Verdict: 1 suggestion to address before merge.

Summary of changes

• New data source tracking deprecated and planned-deprecation models.
• New reference page rendered via .
• now shows a caution banner on planned-deprecation model pages.
• Redirects added for 18 deprecated model URLs (+ updated target for existing redirect).

Issues

• MEDIUM line 41: The caution banner assumes the user arrived via a redirect ("You followed a link..."). This is inaccurate for visitors navigating directly to the reference page. See inline suggestion.

[ask-bonk]

Review summary:

Verdict: 1 suggestion to address before merge.

Summary of changes

• New src/util/deprecated-models.ts data source tracking deprecated and planned-deprecation models.
• New src/content/docs/workers-ai/platform/model-deprecations.mdx reference page rendered via DeprecatedModelPage.astro.
• ModelDetailPage.astro now shows a caution banner on planned-deprecation model pages.
• Redirects added for 18 deprecated model URLs (+ updated target for existing openchat_3.5-awq redirect).

Issues

• MEDIUM src/components/models/DeprecatedModelPage.astro line 41: The caution banner assumes the user arrived via a redirect ("You followed a link..."). This is inaccurate for visitors navigating directly to the reference page. Inline suggestion posted above.

[ask-bonk]

Review complete.

Labels applied: documentation, product:workers, content:new

What changed

• New src/util/deprecated-models.ts data source tracking deprecated and planned-deprecation models.
• New src/content/docs/workers-ai/platform/model-deprecations.mdx reference page, rendered by the new DeprecatedModelPage.astro component.
• ModelDetailPage.astro now conditionally renders a deprecation caution banner on model pages with planned-deprecation status.
• Redirects added for 18 deprecated model URLs to the new reference page, plus an updated target for the pre-existing openchat_3.5-awq redirect.

Issue flagged

• MEDIUM — src/components/models/DeprecatedModelPage.astro line 41: The caution aside reads "You followed a link to a model that is no longer available." This is inaccurate for visitors who navigate directly to the reference page. I posted an inline suggestion to reword it so it works for both redirected users and direct visitors.

Everything else looked solid: frontmatter is valid, redirect formatting is correct, the linked changelog entry exists, and MDX/component usage follows repo conventions.

github run

[github-actions]

Preview URL: https://67dd01e0.preview.developers.cloudflare.com
Preview Branch URL: https://mchen-wai-depr-docs-v2.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/workers-ai/platform/model-deprecations/	https://mchen-wai-depr-docs-v2.preview.developers.cloudflare.com/workers-ai/platform/model-deprecations/

[colbywhite]

@mchenco , unfortunately, I don't think having a deprecation process built on publid/__redirects is going to work moving forward.

If I read this right, every model going forward that is deprecated by your team will require a change to public/__redirects, and thus will require review from @cloudflare/content-engineering (or @cloudflare/product-owners). I don't think you're looking to be bottlenecked like that.

There are other alternatives. If you really prefer the redirect strategy, you can dynamically redirect in your own file (ModelDetailPage perhaps?). I don't think we have a preference of your strategy, it just shouldn't involve public/__redirects.

Also, you currently have content collections in src/content/workers-ai-models/*.json and src/content/catalog-models/*.json. It might be easier for you to maintain long term if you put the deprecation info in the relevant json file. If you prefer to store the similar information in a TypeScript constant, be sure to add src/util/deprecated-models.ts to the code owners as owned by your team. And I think everything in src/components/models is AI-related as well, right? That's another one we likely want to get in the code owners file for your team.

[github-actions]

Hey there, we've marked this pull request as stale because there's no recent activity on it. This label helps us identify PRs that might need updates (or to be closed out by our team if no longer relevant).