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

src/frontend/config/sidebar/docs.topics.ts

@@ -74,7 +74,7 @@ export const docsTopics: StarlightSidebarTopicsUserConfig = {
             'pt-PT': 'Versões anteriores',
             ru: 'Предыдущие версии',
             tr: 'Önceki sürümler',
-            uk: 'Попередні версії',
+            uk: 'Попeredні версії',
             'zh-CN': '以前的版本',
           },
           items: [
@@ -104,6 +104,28 @@ export const docsTopics: StarlightSidebarTopicsUserConfig = {
             },
           ],
         },
+        {
+          label: 'Upgrade Aspire',
+          slug: 'whats-new/upgrade-aspire',
+          translations: {
+            da: 'Opgrader Aspire',
+            de: 'Aspire aktualisieren',
+            en: 'Upgrade Aspire',
+            es: 'Actualizar Aspire',
+            fr: 'Mettre à jour Aspire',
+            hi: 'Aspire अपग्रेड करें',
+            id: 'Tingkatkan Aspire',
+            it: 'Aggiorna Aspire',
+            ja: 'Aspire をアップグレード',
+            ko: 'Aspire 업그레이드',
+            'pt-BR': 'Atualizar Aspire',
+            'pt-PT': 'Atualizar Aspire',
+            ru: 'Обновить Aspire',
+            tr: "Aspire'ı Yükselt",
+            uk: 'Оновити Aspire',
+            'zh-CN': '升级 Aspire',
+          },
+        },
       ],
       translations: {
         da: 'Hvad er nyt',

src/frontend/src/content/docs/whats-new/upgrade-aspire.mdx

@@ -0,0 +1,86 @@
+---
+title: Upgrade Aspire
+description: Learn how to upgrade your Aspire projects to the latest version.
+---
+
+import { Aside, Steps } from '@astrojs/starlight/components';
+import { Kbd } from 'starlight-kbd/components';
+import LearnMore from '@components/LearnMore.astro';
+
+Upgrading Aspire involves updating the **Aspire CLI** itself, the **Aspire SDK**, and all related **packages** in your solution. The `aspire update` command handles most of this for you, but you may also need to review breaking changes and update tooling extensions.
+
+<Aside type="note">
+If you're new to Aspire, there's no reason to upgrade anything. See [prerequisites](/get-started/prerequisites/) and [install Aspire CLI](/get-started/install-cli/) to get started.
+</Aside>
+
+## Upgrade with the Aspire CLI
+
+<Steps>
+
+1. **Update the Aspire CLI** to the latest version:
+
+    ```bash title="Update the Aspire CLI"
+    aspire update --self
+    ```
+
+2. **Update your Aspire solution** by running:
+
+    ```bash title="Update your Aspire solution"
+    aspire update
+    ```
+
+    This command automatically:
+
+    - Updates the [`Aspire.AppHost.Sdk` version](/get-started/aspire-sdk/)
+    - Updates all Aspire NuGet packages to the latest version
+    - Supports both regular projects and Central Package Management (CPM)
+
+</Steps>
+
+<LearnMore>
+For more information, see [`aspire update` command reference](/reference/cli/commands/aspire-update/).
+</LearnMore>
+
+## Update the VS Code extension (optional)
+
+If you have the Aspire extension installed, you can update it to get the latest tooling support:
+
+<Steps>
+
+1. Open VS Code
+2. Go to **Extensions** (<Kbd windows="Ctrl+Shift+X" mac="Cmd+Shift+X" />)
+3. Search for **Aspire**
+4. Click **Update** if an update is available
+
+</Steps>
+
+<LearnMore>
+For more information, see [Aspire extension for VS Code](/get-started/aspire-vscode-extension/).
+</LearnMore>
+
+## Remove the legacy workload (Aspire 8 only)
+
+Still rocking the Aspire workload? No judgment here—we've all been there. 🕰️ Time to let it go and join us in the future!
+
+<Aside type="tip">
+This step is only needed if you're upgrading from Aspire 8. If you're already on Aspire 9 or later, you're good.
+</Aside>
+
+Please remove the **aspire workload** with the following command:
+
+```bash 
+dotnet workload uninstall aspire
+```
+
+## Verify the upgrade
+
+After upgrading, run your application to ensure everything works as expected:
+
+```bash title="Run the Aspire application"
+aspire run
+```
+
+## Need help?
+
+- 🆘 Stuck? [Join the Discord community](https://discord.com/invite/raNPcaaSj8) for real-time support
+- 🐛 Found a bug? [File a GitHub issue](https://github.com/dotnet/aspire/issues/new/choose)