Refine deployment docs and CI/CD guidance

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: davidfowl

.github/skills/doc-writer/SKILL.md

@@ -347,11 +347,11 @@ For client/library packages:
 
 ## AppHost Language Parity (C# and TypeScript)
 
-Aspire supports both **C# AppHosts** (`AppHost.cs`) and **TypeScript AppHosts** (`apphost.ts`). Documentation must treat both languages as first-class citizens. Never write AppHost or hosting-integration documentation with a C#-only bias.
+Aspire supports both **C# AppHosts** (`AppHost.cs`) and **TypeScript AppHosts** (`apphost.ts`). Documentation must treat both languages as first-class citizens. **Always show both C# and TypeScript code samples for AppHost code unless the feature is genuinely language-specific or TypeScript support does not exist yet.** Never write AppHost or hosting-integration documentation with a C#-only bias.
 
 ### Core Principles
 
-1. **Always show both languages**: Every AppHost-focused example or walkthrough must include both C# and TypeScript variants unless the feature is genuinely language-specific.
+1. **Always show both languages**: Every AppHost-focused example, walkthrough, and AppHost code sample must include both C# and TypeScript variants unless the feature is genuinely language-specific.
 2. **Use neutral framing**: Write prose that applies to both languages. Say "In your AppHost" not "In your C# project". Say "Add a Redis resource" not "Call `builder.AddRedis()`".
 3. **Neither language is the default**: Don't present C# first as the "real" example and TypeScript as an afterthought. Both tabs are equal peers.
 4. **Verify TypeScript APIs exist**: Before writing a TypeScript example, confirm the API exists in the TypeScript AppHost SDK. Do not invent TypeScript samples — if you are unsure whether an API is available, flag it for review.

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

@@ -68,57 +68,55 @@ export const deploymentTopics: StarlightSidebarTopicsUserConfig = {
       slug: 'deployment/environments',
     },
     {
-      label: 'Pipelines (aspire do)',
-      slug: 'deployment/pipelines',
+      label: 'Pipelines',
+      collapsed: false,
+      items: [
+        {
+          label: 'Overview',
+          slug: 'deployment/pipelines',
+        },
+        {
+          label: 'Custom deployment pipelines',
+          slug: 'deployment/custom-deployments',
+        },
+        {
+          label: 'Deployment state caching',
+          slug: 'deployment/deployment-state-caching',
+        },
+      ],
+    },
+    {
+      label: 'CI/CD',
+      collapsed: false,
+      items: [
+        {
+          label: 'Overview',
+          slug: 'deployment/ci-cd',
+        },
+        {
+          label: 'Example app lifecycle workflow',
+          slug: 'deployment/app-lifecycle',
+        },
+      ],
+    },
+    {
+      label: 'JavaScript apps',
+      slug: 'deployment/javascript-apps',
     },
     {
-      label: 'Deploy to Docker Compose',
+      label: 'Docker Compose',
       slug: 'deployment/docker-compose',
     },
     {
-      label: 'Deploy to Kubernetes',
+      label: 'Kubernetes',
       slug: 'deployment/kubernetes',
     },
     {
-      label: 'Deploy to Azure',
+      label: 'Azure',
       collapsed: false,
-      translations: {
-        da: 'Udrul til Azure',
-        de: 'In Azure bereitstellen',
-        en: 'Deploy to Azure',
-        es: 'Desplegar en Azure',
-        fr: 'Déployer sur Azure',
-        hi: 'Azure पर तैनात करें',
-        id: 'Deploy ke Azure',
-        it: 'Distribuisci in Azure',
-        ja: 'Azure にデプロイ',
-        ko: 'Azure에 배포',
-        'pt-BR': 'Implantar no Azure',
-        ru: 'Развертывание в Azure',
-        tr: "Azure'a dağıt",
-        uk: 'Розгортання в Azure',
-        'zh-CN': '部署到 Azure',
-      },
       items: [
         {
-          label: 'Deploy using the Aspire CLI',
-          translations: {
-            da: 'Udrul ved hjælp af Aspire CLI',
-            de: 'Bereitstellen mit der Aspire CLI',
-            en: 'Deploy using the Aspire CLI',
-            es: 'Desplegar usando la CLI de Aspire',
-            fr: "Déployer à l'aide de la CLI Aspire",
-            hi: 'Aspire CLI का उपयोग करके तैनात करें',
-            id: 'Deploy menggunakan Aspire CLI',
-            it: 'Distribuisci usando Aspire CLI',
-            ja: 'Aspire CLI を使用したデプロイ',
-            ko: 'Aspire CLI를 사용하여 배포',
-            'pt-BR': 'Implantar usando a CLI do Aspire',
-            ru: 'Развертывание с помощью Aspire CLI',
-            tr: 'Aspire CLI kullanarak dağıt',
-            uk: 'Розгортання за допомогою Aspire CLI',
-            'zh-CN': '使用 Aspire CLI 部署',
-          },
+          label: 'Aspire CLI',
           slug: 'deployment/azure/aca-deployment-aspire-cli',
         },
         {
@@ -162,27 +160,5 @@ export const deploymentTopics: StarlightSidebarTopicsUserConfig = {
         },
       ],
     },
-    {
-      label: 'Deploy JavaScript apps',
-      slug: 'deployment/javascript-apps',
-    },
-    {
-      label: 'App lifecycle (CI/CD)',
-      slug: 'deployment/app-lifecycle',
-    },
-    {
-      label: 'Advanced',
-      collapsed: true,
-      items: [
-        {
-          label: 'Deployment state caching',
-          slug: 'deployment/deployment-state-caching',
-        },
-        {
-          label: 'Custom deployment pipelines',
-          slug: 'deployment/custom-deployments',
-        },
-      ],
-    },
   ],
 };