Update and restructure AI, Caching, Messaging, and Observability integration docs

src/frontend/config/redirects.mjs

@@ -10,7 +10,7 @@ export const redirects = {
   '/integrations/sqlite/': '/integrations/databases/sqlite/sqlite-get-started/',
   '/integrations/sql-server/': '/integrations/databases/sql-server/sql-server-get-started/',
   '/integrations/mysql/': '/integrations/databases/mysql/mysql-get-started/',
-  '/integrations/rabbitmq/': '/integrations/messaging/rabbitmq/',
+  '/integrations/rabbitmq/': '/integrations/messaging/rabbitmq/rabbitmq-get-started/',
   '/integrations/eventstore/': '/integrations/databases/kurrentdb/',
   '/integrations/databases/efcore/mssql/': '/integrations/databases/efcore/mysql/mysql-get-started/',
   '/integrations/databases/mongodb/': '/integrations/databases/mongodb/mongodb-get-started/',
@@ -23,4 +23,15 @@ export const redirects = {
   '/integrations/databases/efcore/postgresql/': '/integrations/databases/efcore/postgres/postgresql-get-started/',
   '/integrations/databases/efcore/azure-postgresql/': '/integrations/databases/efcore/azure-postgresql/azure-postgresql-get-started/',
   '/integrations/databases/efcore/azure-sql/': '/integrations/databases/efcore/azure-sql/azure-sql-get-started/',
+  // Redirects for restructured integrations (Feb 2026)
+  '/integrations/ai/github-models/': '/integrations/ai/github-models/github-models-get-started/',
+  '/integrations/ai/openai/': '/integrations/ai/openai/openai-get-started/',
+  '/integrations/caching/redis/': '/integrations/caching/redis/redis-get-started/',
+  '/integrations/caching/redis-distributed/': '/integrations/caching/redis-distributed/redis-distributed-get-started/',
+  '/integrations/caching/redis-output/': '/integrations/caching/redis-output/redis-output-get-started/',
+  '/integrations/caching/valkey/': '/integrations/caching/valkey/valkey-get-started/',
+  '/integrations/caching/garnet/': '/integrations/caching/garnet/garnet-get-started/',
+  '/integrations/messaging/apache-kafka/': '/integrations/messaging/apache-kafka/apache-kafka-get-started/',
+  '/integrations/messaging/nats/': '/integrations/messaging/nats/nats-get-started/',
+  '/integrations/observability/seq/': '/integrations/observability/seq/seq-get-started/',
 };

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

@@ -116,9 +116,43 @@ export const integrationTopics: StarlightSidebarTopicsUserConfig = {
         'zh-CN': '人工智能 (AI)',
       },
       items: [
-        { label: 'GitHub Models', slug: 'integrations/ai/github-models' },
+        {
+          label: 'GitHub Models',
+          collapsed: true,
+          items: [
+            {
+              label: 'Get started',
+              slug: 'integrations/ai/github-models/github-models-get-started',
+            },
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/ai/github-models/github-models-host',
+            },
+            {
+              label: 'Client integration (Your app)',
+              slug: 'integrations/ai/github-models/github-models-client',
+            },
+          ],
+        },
         { label: 'Ollama', slug: 'integrations/ai/ollama' },
-        { label: 'OpenAI', slug: 'integrations/ai/openai' },
+        {
+          label: 'OpenAI',
+          collapsed: true,
+          items: [
+            {
+              label: 'Get started',
+              slug: 'integrations/ai/openai/openai-get-started',
+            },
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/ai/openai/openai-host',
+            },
+            {
+              label: 'Client integration (Your app)',
+              slug: 'integrations/ai/openai/openai-client',
+            },
+          ],
+        },
       ],
     },
     {
@@ -413,8 +447,16 @@ export const integrationTopics: StarlightSidebarTopicsUserConfig = {
           collapsed: true,
           items: [
             {
-              label: 'Integration overview',
-              slug: 'integrations/caching/redis',
+              label: 'Get started',
+              slug: 'integrations/caching/redis/redis-get-started',
+            },
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/caching/redis/redis-host',
+            },
+            {
+              label: 'Client integration (Your app)',
+              slug: 'integrations/caching/redis/redis-client',
             },
             {
               label: 'Community extensions',
@@ -424,14 +466,76 @@ export const integrationTopics: StarlightSidebarTopicsUserConfig = {
         },
         {
           label: 'Redis Distributed Cache',
-          slug: 'integrations/caching/redis-distributed',
+          collapsed: true,
+          items: [
+            {
+              label: 'Get started',
+              slug: 'integrations/caching/redis-distributed/redis-distributed-get-started',
+            },
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/caching/redis-distributed/redis-distributed-host',
+            },
+            {
+              label: 'Client integration (Your app)',
+              slug: 'integrations/caching/redis-distributed/redis-distributed-client',
+            },
+          ],
         },
         {
           label: 'Redis Output Cache',
-          slug: 'integrations/caching/redis-output',
+          collapsed: true,
+          items: [
+            {
+              label: 'Get started',
+              slug: 'integrations/caching/redis-output/redis-output-get-started',
+            },
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/caching/redis-output/redis-output-host',
+            },
+            {
+              label: 'Client integration (Your app)',
+              slug: 'integrations/caching/redis-output/redis-output-client',
+            },
+          ],
+        },
+        {
+          label: 'Valkey',
+          collapsed: true,
+          items: [
+            {
+              label: 'Get started',
+              slug: 'integrations/caching/valkey/valkey-get-started',
+            },
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/caching/valkey/valkey-host',
+            },
+            {
+              label: 'Client integration (Your app)',
+              slug: 'integrations/caching/valkey/valkey-client',
+            },
+          ],
+        },
+        {
+          label: 'Garnet',
+          collapsed: true,
+          items: [
+            {
+              label: 'Get started',
+              slug: 'integrations/caching/garnet/garnet-get-started',
+            },
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/caching/garnet/garnet-host',
+            },
+            {
+              label: 'Client integration (Your app)',
+              slug: 'integrations/caching/garnet/garnet-client',
+            },
+          ],
         },
-        { label: 'Valkey', slug: 'integrations/caching/valkey' },
-        { label: 'Garnet', slug: 'integrations/caching/garnet' },
       ],
     },
     {
@@ -839,11 +943,59 @@ export const integrationTopics: StarlightSidebarTopicsUserConfig = {
       items: [
         {
           label: 'Apache Kafka',
-          slug: 'integrations/messaging/apache-kafka',
+          collapsed: true,
+          items: [
+            {
+              label: 'Get started',
+              slug: 'integrations/messaging/apache-kafka/apache-kafka-get-started',
+            },
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/messaging/apache-kafka/apache-kafka-host',
+            },
+            {
+              label: 'Client integration (Your app)',
+              slug: 'integrations/messaging/apache-kafka/apache-kafka-client',
+            },
+          ],
         },
         { label: 'LavinMQ', slug: 'integrations/messaging/lavinmq' },
-        { label: 'NATS', slug: 'integrations/messaging/nats' },
-        { label: 'RabbitMQ', slug: 'integrations/messaging/rabbitmq' },
+        {
+          label: 'NATS',
+          collapsed: true,
+          items: [
+            {
+              label: 'Get started',
+              slug: 'integrations/messaging/nats/nats-get-started',
+            },
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/messaging/nats/nats-host',
+            },
+            {
+              label: 'Client integration (Your app)',
+              slug: 'integrations/messaging/nats/nats-client',
+            },
+          ],
+        },
+        {
+          label: 'RabbitMQ',
+          collapsed: true,
+          items: [
+            {
+              label: 'Get started',
+              slug: 'integrations/messaging/rabbitmq/rabbitmq-get-started',
+            },
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/messaging/rabbitmq/rabbitmq-host',
+            },
+            {
+              label: 'Client integration (Your app)',
+              slug: 'integrations/messaging/rabbitmq/rabbitmq-client',
+            },
+          ],
+        },
       ],
     },
     {
@@ -892,7 +1044,26 @@ export const integrationTopics: StarlightSidebarTopicsUserConfig = {
         uk: 'Спостережуваність та ведення журналів',
         'zh-CN': '可观察性与日志记录',
       },
-      items: [{ label: 'Seq', slug: 'integrations/observability/seq' }],
+      items: [
+        {
+          label: 'Seq',
+          collapsed: true,
+          items: [
+            {
+              label: 'Get started',
+              slug: 'integrations/observability/seq/seq-get-started',
+            },
+            {
+              label: 'Hosting integration (AppHost)',
+              slug: 'integrations/observability/seq/seq-host',
+            },
+            {
+              label: 'Client integration (Your app)',
+              slug: 'integrations/observability/seq/seq-client',
+            },
+          ],
+        },
+      ],
     },
     {
       label: 'Reverse proxies & APIs',

src/frontend/src/content/docs/deployment/azure/azure-security-best-practices.mdx

@@ -68,7 +68,7 @@ builder.AddProject<Projects.ApiService>()
        .WithReference(keyVault);
 ```
 
-For more information, see [Aspire Azure Key Vault integration](/integrations/cloud/azure/azure-key-vault/).
+For more information, see [Aspire Azure Key Vault integration](/integrations/cloud/azure/azure-key-vault/azure-key-vault-get-started/).
 
 ### Configure user-assigned managed identities
 
@@ -110,5 +110,5 @@ For comprehensive guidance on Azure security, see [Azure security best practices
 ## Related content
 
 - [Deploy to Azure Container Apps using the Aspire CLI](/deployment/azure/aca-deployment-aspire-cli/)
-- [Aspire Azure Key Vault integration](/integrations/cloud/azure/azure-key-vault/)
+- [Aspire Azure Key Vault integration](/integrations/cloud/azure/azure-key-vault/azure-key-vault-get-started/)
 - [Aspire Azure user-assigned managed identity integration](/integrations/cloud/azure/user-assigned-identity/)

src/frontend/src/content/docs/deployment/overview.mdx

@@ -137,7 +137,7 @@ This example shows how you could explicitly map services to different compute en
 | [📦 Aspire.Hosting.Docker](/integrations/compute/docker/) | Docker / Docker Compose | ✅ Yes | 🧪 Preview | Use generated Compose with your own scripts or tooling. |
 | [📦 Aspire.Hosting.Kubernetes](/integrations/compute/kubernetes/) | Kubernetes | ✅ Yes | 🧪 Preview | Apply with `kubectl`, GitOps, or other controllers. |
 | [📦 Aspire.Hosting.Azure.AppContainers](/integrations/cloud/azure/configure-container-apps/) | Azure Container Apps | ✅ Yes | ✅ Yes (Preview) | Deploy capability is in Preview and may change. |
-| [📦 Aspire.Hosting.Azure.AppService](/integrations/cloud/azure/azure-app-service/) | Azure App Service | ✅ Yes | ✅ Yes (Preview) | Deploy capability is in Preview and may change. |
+| [📦 Aspire.Hosting.Azure.AppService](/integrations/cloud/azure/azure-app-service/azure-app-service-get-started/) | Azure App Service | ✅ Yes | ✅ Yes (Preview) | Deploy capability is in Preview and may change. |
 
 <Aside type="tip">
 Deploy support is integration-specific. Absence of deploy support means you use the published artifacts with external tooling.