Add generic "Upgrade Aspire" article under What's new

[Copilot]

Adds version-agnostic upgrade documentation to complement version-specific release notes. Content adapted from dotnet/docs-aspire upgrade guide, generalized for ongoing use.

Changes

• New article: src/content/docs/whats-new/upgrade-aspire.mdx

  • Prerequisites and recommended upgrade path via Aspire CLI
  • AppHost template evolution (before/after SDK changes)
  • Manual upgrade steps and Upgrade Assistant usage
  • Legacy workload removal for version 8 users

• Sidebar configuration: config/sidebar/docs.topics.ts

  • Positioned under "What's new" at same level as version releases
  • Placed below "Previous versions" section (not nested within)
  • Includes 14 language translations

Interactive components

• PivotSelector/Pivot: Environment-specific instructions (Visual Studio, VS Code, CLI)
• OsAwareTabs: Shell-specific commands (Bash/PowerShell)
• Tabs/TabItem: Workload removal steps by installation source

Example usage:

<PivotSelector
    key="dev-environment"
    options={[
        { id: "visual-studio", title: "Visual Studio" },
        { id: "vscode", title: "Visual Studio Code" },
        { id: "dotnet-cli", title: ".NET CLI" },
    ]}
/>

<Pivot id="visual-studio">
  Visual Studio-specific content
</Pivot>

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/CommunityToolkit/Aspire
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ules/.bin/git git log %D �� %b �� %aN �� %aE ���� --follow t dx --follow e/git-remote-httpnpm git-env && pnpm update:all && cross-env CHECK_LINKS=true astro build git log %D �� %b �� %aN �� %aE ���� --follow p/bin/git 3.mdx --follow _modules/pnpm/diupdate:integrations git (http block)
• https://api.github.com/repos/dotnet/aspire
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ules/.bin/git git log %D �� %b �� %aN �� %aE ���� --follow t dx --follow e/git-remote-httpnpm git-env && pnpm update:all && cross-env CHECK_LINKS=true astro build git log %D �� %b �� %aN �� %aE ���� --follow p/bin/git 3.mdx --follow _modules/pnpm/diupdate:integrations git (http block)
• https://api.github.com/repos/dotnet/aspire-samples
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ules/.bin/git git log %D �� %b �� %aN �� %aE ���� --follow t dx --follow e/git-remote-httpnpm git-env && pnpm update:all && cross-env CHECK_LINKS=true astro build git log %D �� %b �� %aN �� %aE ���� --follow p/bin/git 3.mdx --follow _modules/pnpm/diupdate:integrations git (http block)
• https://api.github.com/repos/microsoft/aspire.dev
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ules/.bin/git git log %D �� %b �� %aN �� %aE ���� --follow t dx --follow e/git-remote-httpnpm git-env && pnpm update:all && cross-env CHECK_LINKS=true astro build git log %D �� %b �� %aN �� %aE ���� --follow p/bin/git 3.mdx --follow _modules/pnpm/diupdate:integrations git (http block)
• https://api.github.com/repos/microsoft/dcp
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ules/.bin/git git log %D �� %b �� %aN �� %aE ���� --follow t dx --follow e/git-remote-httpnpm git-env && pnpm update:all && cross-env CHECK_LINKS=true astro build git log %D �� %b �� %aN �� %aE ���� --follow p/bin/git 3.mdx --follow _modules/pnpm/diupdate:integrations git (http block)
• telemetry.astro.build
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js build (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js build git log %D �� %b �� %aN build --follow ire.dev/node_modules/.bin/git ference/cli/incl/bin/sh --follow ire.dev/src/frongit merge-base origin/main HEAD git log %D �� %b �� %aN �� %aE ���� --follow it -3.mdx --follow cal/bin/git git (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js preview git log �� %aE ���� --follow tools/pnpm/10.28.1/bin/git ference/cli/commsh --follow /git git log %D �� %b �� %aN �� %aE ���� --follow s/.bin/sh -first-test.mdx --follow ire.dev/src/fron--noprofile git (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Please create an "Upgrade Aspire" article that's loosely based on this source content https://github.com/dotnet/docs-aspire/blob/main/docs/get-started/upgrade-to-aspire-13.md - please note there will be pivots and tabs, etc. You should use PivotSelector and Pivot, as well as Tabs and TabItem. Please place this under the What's new sidebar, at the same level as the "What's new in 13.1" but under the below the "Previous versions" section (not in it). Make it generic, not specific to a version.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[Copilot]

Pull request overview

This PR adds a version-agnostic "Upgrade Aspire" guide to help developers upgrade their Aspire projects to the latest version. The article provides straightforward upgrade instructions using the Aspire CLI and alternative upgrade methods.

Changes:

• New upgrade documentation article with CLI-based upgrade instructions
• Sidebar entry positioned below "Previous versions" in the "What's new" section
• Includes 14 language translations for the sidebar entry

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.

File	Description
src/frontend/src/content/docs/whats-new/upgrade-aspire.mdx	New generic upgrade guide covering Aspire CLI upgrade commands, Upgrade Assistant usage, VS Code extension updates, and legacy workload removal
src/frontend/config/sidebar/docs.topics.ts	Adds "Upgrade Aspire" sidebar entry with translations at the same level as version-specific release notes

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.