Repository navigation
Remove deprecated and retired integrations from the catalog, API, and docs - #1892
Merged
David Pine (IEvangelist) merged 2 commits intoOct 15, 2026
Merged
Conversation
Stop publishing gallery entries, docs mappings, and API reference data for packages that are deprecated, retired, or superseded: - CommunityToolkit.Aspire.Hosting.Bun (use Aspire.Hosting.JavaScript) - Aspire.Hosting.GitHub.Models (GitHub Models was retired July 30, 2026) - CommunityToolkit.Aspire.Hosting.Minio and CommunityToolkit.Aspire.Minio.Client - CommunityToolkit.Aspire.Hosting.Python.Extensions (use Aspire.Hosting.Python) - CommunityToolkit.Aspire.Hosting.Dapr.AzureRedis (superseded by the Azure.Dapr and Azure.Dapr.Redis packages) - CommunityToolkit.Aspire.Hosting.Java and CommunityToolkit.Aspire.Hosting.Rust (deprecated in Toolkit 13.6.0 in favor of Aspire.Hosting.Java and Aspire.Hosting.Rust) Add each package to EXCLUDED_PACKAGES so the updater doesn't re-add it through its non-deprecated version fallback, remove its catalog entry, docs mapping, and C# and TypeScript API data, and regenerate the twoslash bundle. The docs pages stay, with their existing deprecation and migration guidance. Replace the three home-page rail tiles that no longer match a gallery entry (GitHub, MinIO, and Bun) with Apache Kafka, ClickHouse, and PowerShell. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 2c9eea84-ba1a-4852-88a7-886ceddb7f4f
David Pine (IEvangelist)
requested a review
from Eric Erhardt (eerhardt)
as a code owner
October 14, 2026 20:15
Contributor
There was a problem hiding this comment.
🔵 Needs a closer look
No blocking defects were identified, but generated routes and homepage rendering still need CI or human verification.
0 open findings
What changed in this PR
Removes eight deprecated, retired, or superseded packages from Aspire’s integration catalog and generated API reference while preserving migration documentation.
Changes:
- Adds explicit updater exclusions to prevent removed packages from returning.
- Deletes related catalog entries, documentation mappings, and API data; regenerates TypeScript declarations.
- Adjusts GitHub Models examples and replaces three homepage integration tiles.
| File | Description |
|---|---|
src/frontend/src/data/twoslash/aspire.d.ts |
Removes declarations for excluded APIs. |
src/frontend/src/data/ts-modules/CommunityToolkit.Aspire.Hosting.Rust.13.5.0.json |
Deletes Toolkit Rust TypeScript API data. |
src/frontend/src/data/ts-modules/CommunityToolkit.Aspire.Hosting.Python.Extensions.13.5.0.json |
Deletes Python Extensions TypeScript API data. |
src/frontend/src/data/ts-modules/CommunityToolkit.Aspire.Hosting.Minio.13.5.0.json |
Deletes MinIO TypeScript API data. |
src/frontend/src/data/ts-modules/CommunityToolkit.Aspire.Hosting.Java.13.5.0.json |
Deletes Toolkit Java TypeScript API data. |
src/frontend/src/data/ts-modules/CommunityToolkit.Aspire.Hosting.Bun.13.3.0.json |
Deletes Toolkit Bun TypeScript API data. |
src/frontend/src/data/ts-modules/Aspire.Hosting.GitHub.Models.13.5.4.json |
Deletes GitHub Models TypeScript API data. |
src/frontend/src/data/pkgs/CommunityToolkit.Aspire.Minio.Client.13.5.0.json |
Deletes MinIO client C# API data. |
src/frontend/src/data/pkgs/CommunityToolkit.Aspire.Hosting.Rust.13.5.0.json |
Deletes Toolkit Rust C# API data. |
src/frontend/src/data/pkgs/CommunityToolkit.Aspire.Hosting.Python.Extensions.13.5.0.json |
Deletes Python Extensions C# API data. |
src/frontend/src/data/pkgs/CommunityToolkit.Aspire.Hosting.Minio.13.5.0.json |
Deletes MinIO hosting C# API data. |
src/frontend/src/data/pkgs/CommunityToolkit.Aspire.Hosting.Dapr.AzureRedis.9.1.1-beta.197.json |
Deletes superseded Dapr AzureRedis API data. |
src/frontend/src/data/pkgs/CommunityToolkit.Aspire.Hosting.Bun.13.3.0.json |
Deletes Toolkit Bun C# API data. |
src/frontend/src/data/pkgs/Aspire.Hosting.GitHub.Models.13.5.4.json |
Deletes GitHub Models C# API data. |
src/frontend/src/data/integration-docs.json |
Removes five package-to-documentation mappings. |
src/frontend/src/data/aspire-integrations.json |
Removes eight catalog entries. |
src/frontend/src/content/docs/integrations/ai/github-models/github-models-host.mdx |
Removes references and validation tied to deleted API data. |
src/frontend/src/components/home/HomeIntegrationRail.astro |
Replaces retired-package tiles with active integrations. |
src/frontend/scripts/update-integrations.ts |
Explicitly excludes all eight packages from updates. |
🧠 Review effort: Balanced
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Delete the three retired GitHub Models integration pages and the icons that only they and the home rail used, drop the sidebar group, and redirect the old URLs to the Microsoft Foundry integration. Fix inbound links in the what's new pages. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 2c9eea84-ba1a-4852-88a7-886ceddb7f4f
David Pine (IEvangelist)
changed the title
Contributor
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
Eric Erhardt (eerhardt)
approved these changes
Oct 15, 2026
David Pine (IEvangelist)
deleted the
ievangelist-deprecated-nuget-packages
branch
October 15, 2026 15:09
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
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.
Summary
Removes packages that are deprecated, retired, or superseded from the integration catalog, API reference data, and docs, so the gallery,
/reference/api/, and the integrations section stop advertising them. NuGet deprecation flags alone missed most of these, so the audit also used package READMEs and nuspecs, the Aspire CLI's hidden-package list, Community Toolkit release notes, and the Toolkit source tree.CommunityToolkit.Aspire.Hosting.BunAspire.Hosting.JavaScript.Aspire.Hosting.GitHub.Modelsaspire add.CommunityToolkit.Aspire.Hosting.Minio,CommunityToolkit.Aspire.Minio.ClientCommunityToolkit.Aspire.Hosting.Python.ExtensionsAspire.Hosting.Python.CommunityToolkit.Aspire.Hosting.Dapr.AzureRedisAzure.DaprandAzure.Dapr.Redis. It has no source in the Toolkit repository.CommunityToolkit.Aspire.Hosting.Java,CommunityToolkit.Aspire.Hosting.RustAspire.Hosting.JavaandAspire.Hosting.Rust.What changed (all under
src/frontend/)scripts/update-integrations.ts: added each package toEXCLUDED_PACKAGES. The updater falls back to the newest non-deprecated version, which is how Bun came back at 13.3.0, so the exclusion has to be explicit.src/data/aspire-integrations.json(from 217 to 209 entries) andsrc/data/integration-docs.json(from 165 to 160 mappings): removed the entries.src/data/pkgs/andsrc/data/ts-modules/: deleted the C# and TypeScript API data for the removed packages (14 files).src/data/twoslash/aspire.d.tsis regenerated.src/content/docs/integrations/ai/github-models/: deleted the three GitHub Models pages (get started, host, connect) and their sidebar group inconfig/sidebar/integrations.topics.ts.config/redirects.mjs: the old GitHub Models URLs (the section root, get started, host, connect, and the legacy-clientroute) now redirect to the matching Microsoft Foundry pages instead of returning 404.src/content/docs/whats-new/: fixed links to the removed pages. The 13.6 note no longer links to the deleted migration guide, and the 13.2 connection-properties example drops "Connect to GitHub Models". The 9.4 and 9.5 notes linked to absoluteaspire.devURLs that would now land on a Foundry page, so those links are removed.src/assets/icons/: deletedgithub-icon.png(only the removed pages used it), plusgithub-light-icon.pngandminio-icon.png, which the home-page rail change orphaned.HomeIntegrationRail.astro: three tiles (GitHub, MinIO, Bun) no longer matched any gallery entry, so they now show Apache Kafka, ClickHouse, and PowerShell. That keeps 12 tiles per lane and 36 unique names.Review notes
Dapr.AzureRedis, ToolkitJava, and ToolkitRustaren't flagged on NuGet. Java and Rust are announced as deprecated but still publish betas, so drop them from this PR if you'd rather wait for the Toolkit to remove them.rust-host.mdxstill points to the Toolkit Rust package for Bacon support (AddBaconApp). That stays accurate while the package is on NuGet.Aspire.Hosting.DocumentDB, and the 13.6.0 preview packages.Third-party links and affiliations
None.
Validation
Run from
src/frontend/:pnpm test:unit: passed (81 files, 1,121 tests, 1 skipped). Covers the redirect, Astro config, resource catalog, API reference, TypeScript API, Twoslash, and updater tests.pnpm test:unit:structured-data: passed (5 files, 99 tests).pnpm validate:api-data: passed (209 catalog package identities reconciled, 140 TypeScript modules matched to C# provenance).node scripts/generate-twoslash-types.ts: succeeded and produced no diff against the committedaspire.d.ts.pnpm exec eslint config/redirects.mjs config/sidebar/integrations.topics.ts --max-warnings 0: passed.github-modelsURLs.Not run locally:
pnpm build(which runs thestarlight-links-validatorlink check) and the Playwright e2e suite. CI covers them.