Let's see what this looks like (#140)

* Let's see what this looks like

* More clean up and fixes

* Remove leading topic from hub

* Even more updates

.openpublishing.redirection.json

@@ -3,6 +3,26 @@
         {
             "source_path_from_root": "/docs/storage/quickstart-azure-storage.md",
             "redirect_url": "/dotnet/aspire/storage/azure-storage"
+        },
+        {
+            "source_path_from_root": "/docs/storage/azure-storage.md",
+            "redirect_url": "/dotnet/aspire/storage/azure-storage-components"
+        },
+        {
+            "source_path_from_root": "/docs/database/quickstart-sql-server.md",
+            "redirect_url": "/dotnet/aspire/database/sql-server-components"
+        },
+        {
+            "source_path_from_root": "/docs/get-started/quickstart-build-your-first-aspire-app.md",
+            "redirect_url": "/dotnet/aspire/get-started/build-your-first-aspire-app"
+        },
+        {
+            "source_path_from_root": "/docs/messaging/quickstart-messaging.md",
+            "redirect_url": "/dotnet/aspire/messaging/messaging-components"
+        },
+        {
+            "source_path_from_root": "/docs/caching/quickstart-caching.md",
+            "redirect_url": "/dotnet/aspire/caching/caching-components"
         }
     ]
 }

docs/caching/quickstart-caching.md → docs/caching/caching-components.md

@@ -1,11 +1,11 @@
 ---
 title: Implement caching with .NET Aspire components
 description: Learn how to connect to Redis and cache data using .NET Aspire components.
-ms.date: 11/15/2023
-ms.topic: quickstart
+ms.date: 12/07/2023
+ms.topic: tutorial
 ---
 
-# Quickstart: Implement caching with .NET Aspire components
+# Tutorial: Implement caching with .NET Aspire components
 
 Cloud-native apps often require various types of scalable caching solutions to improve performance. .NET Aspire components simplify the process of connecting to popular caching services such as Redis. In this quickstart, you'll learn how to:
 

docs/dashboard.md

@@ -13,7 +13,7 @@ In the upcoming sections, you'll discover how to create a .NET Aspire app and em
 
 > [!div class="checklist"]
 >
-> - Investigate the dashboard's capabilities by using the app generated from the project template as explained in the [Quickstart: Build your first .NET Aspire app.](get-started/quickstart-build-your-first-aspire-app.md)
+> - Investigate the dashboard's capabilities by using the app generated from the project template as explained in the [Quickstart: Build your first .NET Aspire app.](get-started/build-your-first-aspire-app.md)
 >
 > - Delve into the features of the .NET Aspire dashboard app.
 

docs/database/quickstart-sql-server.md → docs/database/sql-server-components.md

@@ -1,7 +1,7 @@
 ---
 title: Connect an ASP.NET Core app to SQL Server using .NET Aspire and Entity Framework Core
-description: Learn how to connect an ASP.NET Core app to .NET Aspire storage components.
-ms.date: 12/01/2023
+description: Learn how to connect an ASP.NET Core app to to SQL Server using .NET Aspire and Entity Framework Core.
+ms.date: 12/07/2023
 ms.topic: tutorial
 ---
 
@@ -100,7 +100,7 @@ Replace the contents of the _Program.cs_ file in the _AspireSQLEFCore.AppHost_ p
 
 The preceding code adds a SQL Server Container resource to your app and configures a connection to a database called `sqldata`. The Entity Framework classes you configured earlier will automatically use this connection when migrating and connecting to the database. The `sqlpassword` variable represents the password for the default database user in the SQL Server container.
 
-Set a `sqlpassword` key in the [user secrets](/aspnet/core/security/app-secrets?view=aspnetcore-8.0&tabs=windows) store of the _AspireSQLEFCore.AppHost_ project using the `dotnet user-secrets` command in the AppHost project directory. Passwords must meet the [Password Policy](/sql/relational-databases/security/password-policy?view=sql-server-ver16#password-complexity) complexity requirements.
+Set a `sqlpassword` key in the [user secrets](/aspnet/core/security/app-secrets) store of the _AspireSQLEFCore.AppHost_ project using the `dotnet user-secrets` command in the AppHost project directory. Passwords must meet the [Password Policy](/sql/relational-databases/security/password-policy#password-complexity) complexity requirements.
 
 ```dotnetcli
 dotnet user-secrets set sqlpassword <password>

docs/deployment/k8s-deployment.md

@@ -1,7 +1,7 @@
 ---
 title: Deploy .NET Aspire apps to a Kubernetes cluster
 description: Learn how to use the Aspirate tool to deploy .NET Aspire apps to a Kubernetes cluster.
-ms.date: 12/06/2023
+ms.date: 12/07/2023
 ---
 
 # Deploy .NET Aspire apps to a Kubernetes cluster

docs/get-started/aspire-overview.md

@@ -1,15 +1,14 @@
 ---
 title: .NET Aspire overview
 description: Learn about .NET Aspire, an application stack designed to improve the experience of building cloud-native applications.
-ms.date: 11/27/2023
+ms.date: 12/07/2023
 ---
 
 # .NET Aspire overview
 
 .NET Aspire is an opinionated, cloud ready stack for building observable, production ready, distributed applications.​ .NET Aspire is delivered through a collection of NuGet packages that handle specific cloud-native concerns. Cloud-native apps often consist of small, interconnected pieces or microservices rather than a single, monolithic code base. Cloud-native apps generally consume a large number of services, such as databases, messaging, and caching.
 
-> [!NOTE]
-> A _distributed application_ is one that uses computational resources across multiple nodes, such as containers run on different hosts. Such nodes must communicate across the network to deliver responses to users. A cloud-native app is a specific type of distributed app that takes full advantage of the scalability, resilience, and manageability of cloud infrastructures.
+A _distributed application_ is one that uses computational resources across multiple nodes, such as containers running on different hosts. Such nodes must communicate over network boundaries to deliver responses to users. A cloud-native app is a specific type of distributed app that takes full advantage of the scalability, resilience, and manageability of cloud infrastructures.
 
 ## Why .NET Aspire?
 
@@ -97,4 +96,4 @@ When added to your _Program.cs_ file, the preceding code handles the following c
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Quickstart: Build your first .NET Aspire app](quickstart-build-your-first-aspire-app.md)
+> [Quickstart: Build your first .NET Aspire app](build-your-first-aspire-app.md)

docs/get-started/quickstart-build-your-first-aspire-app.md → docs/get-started/build-your-first-aspire-app.md

@@ -1,7 +1,7 @@
 ---
 title: Build your first .NET Aspire app
 description: Learn how to build your first .NET Aspire app using the .NET Aspire Started Application template.
-ms.date: 11/15/2023
+ms.date: 12/07/2023
 ms.topic: quickstart
 ms.prod: dotnet
 ---

docs/index.yml

@@ -10,16 +10,16 @@ metadata:
   ms.topic: hub-page
   ms.prod: dotnet-cloud-native
   ms.service: dotnet-aspire
-  ms.date: 11/27/2023
+  ms.date: 12/07/2023
 
 highlightedContent:
   items:
     - itemType: overview
-      title: What is .NET Aspire?
+      title: .NET Aspire overview
       url: get-started/aspire-overview.md
     - itemType: quickstart
       title: Build your first .NET Aspire app
-      url: get-started/quickstart-build-your-first-aspire-app.md
+      url: get-started/build-your-first-aspire-app.md
     - itemType: concept
       title: Distributed app host
       url: app-host-overview.md
@@ -47,9 +47,9 @@ conceptualContent:
         - itemType: concept
           text: .NET Aspire overview
           url: get-started/aspire-overview.md
-        - itemType: concept
+        - itemType: quickstart
           text: Build your first .NET Aspire app
-          url: get-started/quickstart-build-your-first-aspire-app.md
+          url: get-started/build-your-first-aspire-app.md
         - itemType: how-to-guide
           text: .NET Aspire setup and tooling
           url: setup-tooling.md
@@ -66,8 +66,8 @@ conceptualContent:
     - title: Storage
       links:
         - itemType: tutorial
-          text: Tutorial - Connect to storage with .NET Aspire
-          url: storage/azure-storage.md
+          text: Connect to storage with .NET Aspire
+          url: storage/azure-storage-components.md
         - itemType: how-to-guide
           text: Azure Blob Storage
           url: storage/azure-storage-blobs-component.md
@@ -80,9 +80,9 @@ conceptualContent:
 
     - title: Database
       links:
-        - itemType: quickstart
-          text: Tutorial - Connect to SQL Server with EF Core
-          url: database/quickstart-sql-server.md
+        - itemType: tutorial
+          text: Connect to SQL Server with EF Core
+          url: database/sql-server-components.md
         - itemType: how-to-guide
           text: PostgreSQL database
           url: database/postgresql-component.md
@@ -105,8 +105,8 @@ conceptualContent:
     - title: Messaging
       links:
         - itemType: tutorial
-          text: Tutorial - Implement Messaging with .NET Aspire
-          url: messaging/quickstart-messaging.md
+          text: Implement Messaging with .NET Aspire
+          url: messaging/messaging-components.md
         - itemType: overview
           text: Azure Service Bus
           url: messaging/azure-service-bus-component.md
@@ -117,8 +117,8 @@ conceptualContent:
     - title: Caching
       links:
         - itemType: tutorial
-          text: Tutorial - Improve app caching with .NET Aspire
-          url: caching/quickstart-caching.md
+          text: Improve app caching with .NET Aspire
+          url: caching/caching-components.md
         - itemType: how-to-guide
           text: Redis caching
           url: caching/stackexchange-redis-component.md
@@ -143,6 +143,9 @@ conceptualContent:
         - itemType: how-to-guide
           text: Integrate with Application Insights
           url: deployment/azure/application-insights.md
+        - itemType: how-to-guide
+          text: Deploy to a Kubernetes cluster with Aspirate
+          url: deployment/k8s-deployment.md
 
 additionalContent:
   sections:

docs/messaging/quickstart-messaging.md → docs/messaging/messaging-components.md

@@ -1,8 +1,8 @@
 ---
 title: Use .NET Aspire messaging components in ASP.NET Core
 description: Learn how to connect an ASP.NET Core app to messaging services using .NET Aspire components.
-ms.date: 11/15/2023
-ms.topic: quickstart
+ms.date: 12/07/2023
+ms.topic: tutorial
 ---
 
 # Tutorial: Use .NET Aspire messaging components in ASP.NET Core

docs/reference/aspire-faq.yml

@@ -62,5 +62,5 @@ additionalContent: |
   To learn more about networking and functions:
 
   * [.NET Aspire overview](../get-started/aspire-overview.md)
-  * [Build your first .NET Aspire app](../get-started/quickstart-build-your-first-aspire-app.md)
+  * [Build your first .NET Aspire app](../get-started/build-your-first-aspire-app.md)
   * [.NET Aspire components](../components-overview.md)

docs/service-defaults.md

@@ -11,7 +11,7 @@ Cloud-native applications often require extensive configurations to ensure they
 
 ## Explore the service defaults project
 
-When you either [**Enlist in .NET Aspire orchestration**](setup-tooling.md#enlist-in-orchestration) or [create a new .NET Aspire project](get-started/quickstart-build-your-first-aspire-app.md), the _YourAppName.ServiceDefaults_ project is added to your solution. For example, when building an API, you call the `AddServiceDefaults` method in the _Program.cs_ file of your apps:
+When you either [**Enlist in .NET Aspire orchestration**](setup-tooling.md#enlist-in-orchestration) or [create a new .NET Aspire project](get-started/build-your-first-aspire-app.md), the _YourAppName.ServiceDefaults_ project is added to your solution. For example, when building an API, you call the `AddServiceDefaults` method in the _Program.cs_ file of your apps:
 
 ```csharp
 builder.AddServiceDefaults();

docs/storage/azure-storage.md → docs/storage/azure-storage-components.md

@@ -1,7 +1,7 @@
 ---
 title: Connect an ASP.NET Core app to .NET Aspire storage components
 description: Learn how to connect an ASP.NET Core app to .NET Aspire storage components.
-ms.date: 12/01/2023
+ms.date: 12/07/2023
 ms.topic: tutorial
 zone_pivot_groups: azure-storage-mechanism
 ---

docs/toc.yml

@@ -5,12 +5,12 @@ items:
   - name: Get Started
     expanded: true
     items:
-      - name: What is .NET Aspire?
+      - name: .NET Aspire overview
         displayName: aspire overview,architecture,key concepts
         href: get-started/aspire-overview.md
       - name: Quickstart - Build your first .NET Aspire app
         displayName: quickstart,first app,aspire app
-        href: get-started/quickstart-build-your-first-aspire-app.md
+        href: get-started/build-your-first-aspire-app.md
       - name: Tutorial - Add .NET Aspire to an existing app
         href: get-started/add-aspire-existing-app.md
       - name: Setup and tooling
@@ -41,7 +41,7 @@ items:
   - name: Storage
     items:
       - name: Tutorial - Connect to storage
-        href: storage/azure-storage.md
+        href: storage/azure-storage-components.md
       - name: Azure Blob Storage component
         href: storage/azure-storage-blobs-component.md
       - name: Azure Storage Queues component
@@ -52,7 +52,7 @@ items:
   - name: Database
     items:
       - name: Tutorial - Connect to SQL Server with EF Core
-        href: database/quickstart-sql-server.md
+        href: database/sql-server-components.md
       - name: PostgreSQL Database component
         href: database/postgresql-component.md
       - name: PostgreSQL - EF Core component
@@ -69,7 +69,7 @@ items:
   - name: Messaging
     items:
       - name: Tutorial - Messaging using .NET Aspire components
-        href: messaging/quickstart-messaging.md
+        href: messaging/messaging-components.md
       - name: Azure Service Bus component
         href: messaging/azure-service-bus-component.md
       - name: RabbitMQ service broker component
@@ -78,7 +78,7 @@ items:
   - name: Caching
     items:
       - name: Tutorial - Caching using Redis components
-        href: caching/quickstart-caching.md
+        href: caching/caching-components.md
       - name: Redis Caching component
         href: caching/stackexchange-redis-component.md
       - name: Redis Output Caching component
@@ -99,14 +99,18 @@ items:
         items:
           - name: Tutorial - Azure Container Apps
             href: deployment/azure/aca-deployment.md
+            displayName: azure container apps,aca
           - name: Azure Container Apps with AZD (In-depth)
             href: deployment/azure/aca-deployment-azd-in-depth.md
+            displayName: azure container apps,aca,azd
           - name: Use .NET Aspire with Application Insights
             href: deployment/azure/application-insights.md
+            displayName: app insights
       - name: Kubernetes
         items:
         - name: Deploy .NET Aspire apps to a Kubernetes cluster
           href: deployment/k8s-deployment.md
+          displayName: kubernetes,aspire kubernetes,aspire k8s
       - name: Reference - Tool-builder manifest schemas
         href: deployment/manifest-format.md