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