Merge pull request #1377 from dotnet/main

✅ Merge `main` into `live`

docs/azureai/azureai-openai-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire Azure AI OpenAI component
 description: Learn how to use the .NET Aspire Azure AI OpenAI component.
 ms.topic: how-to
-ms.date: 06/26/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire Azure AI OpenAI component
@@ -16,7 +16,7 @@ For more information on using the `OpenAIClient`, see [Quickstart: Get started g
 - Azure subscription: [create one for free](https://azure.microsoft.com/free/).
 - Azure AI OpenAI or OpenAI account: [create an Azure OpenAI Service resource](/azure/ai-services/openai/how-to/create-resource).
 
-To get started with the .NET Aspire Azure AI OpenAI component, install the [Aspire.Azure.AI.OpenAI](https://www.nuget.org/packages/Aspire.Azure.AI.OpenAI) NuGet package.
+To get started with the .NET Aspire Azure AI OpenAI component, install the [Aspire.Azure.AI.OpenAI](https://www.nuget.org/packages/Aspire.Azure.AI.OpenAI) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 
@@ -54,7 +54,7 @@ public class ExampleService(OpenAIClient client)
 
 ## App host usage
 
-To add Azure AI hosting support to your <xref:Aspire.Hosting.IDistributedApplicationBuilder>, install the [Aspire.Hosting.Azure.CognitiveServices](https://www.nuget.org/packages/Aspire.Hosting.Azure.CognitiveServices) NuGet package.
+To add Azure AI hosting support to your <xref:Aspire.Hosting.IDistributedApplicationBuilder>, install the [Aspire.Hosting.Azure.CognitiveServices](https://www.nuget.org/packages/Aspire.Hosting.Azure.CognitiveServices) NuGet package in the [app host](xref:aspire/app-host) project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/azureai/azureai-search-document-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire Azure AI Search Documents component
 description: Learn how to use the .NET Aspire Azure AI Search Documents component.
 ms.topic: how-to
-ms.date: 06/26/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire Azure AI Search Documents component
@@ -16,7 +16,7 @@ For more information on using the `SearchIndexClient`, see [How to use Azure.Sea
 - Azure subscription: [create one for free](https://azure.microsoft.com/free/).
 - Azure Search service: [create an Azure AI Search service resource](/azure/search/search-create-service-portal).
 
-To get started with the .NET Aspire Azure AI Search Documents component, install the [Aspire.Azure.Search.Documents](https://www.nuget.org/packages/Aspire.Azure.Search.Documents) NuGet package.
+To get started with the .NET Aspire Azure AI Search Documents component, install the [Aspire.Azure.Search.Documents](https://www.nuget.org/packages/Aspire.Azure.Search.Documents) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 
@@ -75,7 +75,7 @@ For more information, see the [Azure AI Search client library for .NET](/dotnet/
 
 ## App host usage
 
-To add Azure AI hosting support to your <xref:Aspire.Hosting.IDistributedApplicationBuilder>, install the [Aspire.Hosting.Azure.Search](https://www.nuget.org/packages/Aspire.Hosting.Azure.Search) NuGet package.
+To add Azure AI hosting support to your <xref:Aspire.Hosting.IDistributedApplicationBuilder>, install the [Aspire.Hosting.Azure.Search](https://www.nuget.org/packages/Aspire.Hosting.Azure.Search) NuGet package in the [app host](xref:aspire/app-host) project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/caching/includes/redis-app-host.md

@@ -1,4 +1,4 @@
-To model the Redis resource in the app host, install the [Aspire.Hosting.Redis](https://www.nuget.org/packages/Aspire.Hosting.Redis) NuGet package.
+To model the Redis resource in the app host, install the [Aspire.Hosting.Redis](https://www.nuget.org/packages/Aspire.Hosting.Redis) NuGet package in the [app host](xref:aspire/app-host) project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/caching/stackexchange-redis-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire Stack Exchange Redis component
 description: This article describes the .NET Aspire Stack Exchange Redis component features and capabilities
 ms.topic: how-to
-ms.date: 06/11/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire Stack Exchange Redis component
@@ -11,7 +11,7 @@ In this article, you learn how to use the .NET Aspire Stack Exchange Redis compo
 
 ## Get started
 
-To get started with the .NET Aspire Stack Exchange Redis component, install the [Aspire.StackExchange.Redis](https://www.nuget.org/packages/Aspire.StackExchange.Redis) NuGet package.
+To get started with the .NET Aspire Stack Exchange Redis component, install the [Aspire.StackExchange.Redis](https://www.nuget.org/packages/Aspire.StackExchange.Redis) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/caching/stackexchange-redis-distributed-caching-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire Stack Exchange Redis distributed caching component
 description: This article describes the .NET Aspire Stack Exchange Redis distributed caching component features and capabilities
 ms.topic: how-to
-ms.date: 06/11/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire Stack Exchange Redis distributed caching component
@@ -11,7 +11,7 @@ In this article, you learn how to use the .NET Aspire Stack Exchange Redis distr
 
 ## Get started
 
-To get started with the .NET Aspire Stack Exchange Redis distributed caching component, install the [Aspire.StackExchange.Redis.DistributedCaching](https://www.nuget.org/packages/Aspire.StackExchange.Redis.DistributedCaching) NuGet package.
+To get started with the .NET Aspire Stack Exchange Redis distributed caching component, install the [Aspire.StackExchange.Redis.DistributedCaching](https://www.nuget.org/packages/Aspire.StackExchange.Redis.DistributedCaching) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/caching/stackexchange-redis-output-caching-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire Stack Exchange Redis output caching Component
 description: This article describes the .NET Aspire Stack Exchange Redis output caching component features and capabilities
 ms.topic: how-to
-ms.date: 06/11/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire Stack Exchange Redis output caching component
@@ -11,7 +11,7 @@ In this article, you learn how to use the .NET Aspire Stack Exchange Redis outpu
 
 ## Get started
 
-To get started with the .NET Aspire Stack Exchange Redis output caching component, install the [Aspire.StackExchange.Redis.OutputCaching](https://www.nuget.org/packages/Aspire.StackExchange.Redis.OutputCaching) NuGet package.
+To get started with the .NET Aspire Stack Exchange Redis output caching component, install the [Aspire.StackExchange.Redis.OutputCaching](https://www.nuget.org/packages/Aspire.StackExchange.Redis.OutputCaching) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/azure-cosmos-db-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire Azure Cosmos DB component
 description: This article describes the .NET Aspire Azure Cosmos DB component features and capabilities.
 ms.topic: how-to
-ms.date: 06/28/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire Azure Cosmos DB component
@@ -11,7 +11,7 @@ In this article, you learn how to use the .NET Aspire Azure Cosmos DB component.
 
 ## Get started
 
-To get started with the .NET Aspire Azure Cosmos DB component, install the [Aspire.Microsoft.Azure.Cosmos](https://www.nuget.org/packages/Aspire.Microsoft.Azure.Cosmos) NuGet package.
+To get started with the .NET Aspire Azure Cosmos DB component, install the [Aspire.Microsoft.Azure.Cosmos](https://www.nuget.org/packages/Aspire.Microsoft.Azure.Cosmos) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 
@@ -51,7 +51,7 @@ For more information on using the <xref:Microsoft.Azure.Cosmos.CosmosClient>, se
 
 ## App host usage
 
-To add Azure Cosmos DB hosting support to your <xref:Aspire.Hosting.IDistributedApplicationBuilder>, install the [Aspire.Hosting.Azure.CosmosDB](https://www.nuget.org/packages/Aspire.Hosting.Azure.CosmosDB) NuGet package.
+To add Azure Cosmos DB hosting support to your <xref:Aspire.Hosting.IDistributedApplicationBuilder>, install the [Aspire.Hosting.Azure.CosmosDB](https://www.nuget.org/packages/Aspire.Hosting.Azure.CosmosDB) NuGet package in the [app host](xref:aspire/app-host) project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/azure-cosmos-db-entity-framework-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire Microsoft Entity Framework Core Cosmos DB component
 description: This article describes the .NET Aspire Microsoft Entity Framework Core Cosmos DB component features and capabilities.
 ms.topic: how-to
-ms.date: 06/05/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire Microsoft Entity Framework Core Cosmos DB component
@@ -11,7 +11,7 @@ In this article, you learn how to use the .NET Aspire Microsoft Entity Framework
 
 ## Get started
 
-To get started with the .NET Aspire Microsoft Entity Framework Core Cosmos DB component, install the [Aspire.Microsoft.EntityFrameworkCore.Cosmos](https://www.nuget.org/packages/Aspire.Microsoft.EntityFrameworkCore.Cosmos) NuGet package.
+To get started with the .NET Aspire Microsoft Entity Framework Core Cosmos DB component, install the [Aspire.Microsoft.EntityFrameworkCore.Cosmos](https://www.nuget.org/packages/Aspire.Microsoft.EntityFrameworkCore.Cosmos) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 
@@ -51,7 +51,7 @@ For more information on using Entity Framework Core with Azure Cosmos DB, see th
 
 ## App host usage
 
-To add Azure Cosmos DB hosting support to your <xref:Aspire.Hosting.IDistributedApplicationBuilder>, install the [Aspire.Hosting.Azure.CosmosDB](https://www.nuget.org/packages/Aspire.Hosting.Azure.CosmosDB) NuGet package.
+To add Azure Cosmos DB hosting support to your <xref:Aspire.Hosting.IDistributedApplicationBuilder>, install the [Aspire.Hosting.Azure.CosmosDB](https://www.nuget.org/packages/Aspire.Hosting.Azure.CosmosDB) NuGet package in the [app host](xref:aspire/app-host) project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/includes/mysql-app-host.md

@@ -1,4 +1,4 @@
-To model the MySql resource in the app host, install the [Aspire.Hosting.MySql](https://www.nuget.org/packages/Aspire.Hosting.MySql) NuGet package.
+To model the MySql resource in the app host, install the [Aspire.Hosting.MySql](https://www.nuget.org/packages/Aspire.Hosting.MySql) NuGet package in the [app host](xref:aspire/app-host) project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/includes/postgresql-app-host.md

@@ -1,4 +1,4 @@
-To model the PostgreSQL server resource in the app host, install the [Aspire.Hosting.PostgreSQL](https://www.nuget.org/packages/Aspire.Hosting.PostgreSQL) NuGet package.
+To model the PostgreSQL server resource in the app host, install the [Aspire.Hosting.PostgreSQL](https://www.nuget.org/packages/Aspire.Hosting.PostgreSQL) NuGet package in the [app host](xref:aspire/app-host) project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/includes/sql-app-host.md

@@ -1,4 +1,4 @@
-To model the SqlServer resource in the app host, install the [Aspire.Hosting.SqlServer](https://www.nuget.org/packages/Aspire.Hosting.SqlServer) NuGet package.
+To model the SqlServer resource in the app host, install the [Aspire.Hosting.SqlServer](https://www.nuget.org/packages/Aspire.Hosting.SqlServer) NuGet package in the [app host](xref:aspire/app-host) project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/mongodb-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire MongoDB database component
 description: This article describes the .NET Aspire MongoDB database component.
 ms.topic: how-to
-ms.date: 06/05/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire MongoDB database component
@@ -19,7 +19,7 @@ In this article, you learn how to use the .NET Aspire MongoDB database component
 
 ## Get started
 
-To get started with the .NET Aspire MongoDB database component, install the [Aspire.MongoDB.Driver](https://www.nuget.org/packages/Aspire.MongoDB.Driver) NuGet package.
+To get started with the .NET Aspire MongoDB database component, install the [Aspire.MongoDB.Driver](https://www.nuget.org/packages/Aspire.MongoDB.Driver) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 
@@ -59,7 +59,7 @@ After adding a `IMongoClient`, you can require the `IMongoClient` instance using
 
 ## App host usage
 
-To model the MongoDB resource in the app host, install the [Aspire.Hosting.MongoDB](https://www.nuget.org/packages/Aspire.Hosting.MongoDB) NuGet package.
+To model the MongoDB resource in the app host, install the [Aspire.Hosting.MongoDB](https://www.nuget.org/packages/Aspire.Hosting.MongoDB) NuGet package in the [app host](xref:aspire/app-host) project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/mysql-entity-framework-component.md

@@ -1,7 +1,7 @@
 ---
 title: MySQL Entity Framework Component
 description: MySQL Entity Framework Component
-ms.date: 06/28/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire Pomelo MySQL Entity Framework Component
@@ -10,7 +10,7 @@ In this article, you learn how to use the The .NET Aspire Pomelo MySQL Entity Fr
 
 ## Get started
 
-You need a MySQL database and connection string for accessing the database. To get started with the The .NET Aspire Pomelo MySQL Entity Framework Core component, install the [Aspire.Pomelo.EntityFrameworkCore.MySql](https://www.nuget.org/packages/Aspire.Pomelo.EntityFrameworkCore.MySql) NuGet package.
+You need a MySQL database and connection string for accessing the database. To get started with the The .NET Aspire Pomelo MySQL Entity Framework Core component, install the [Aspire.Pomelo.EntityFrameworkCore.MySql](https://www.nuget.org/packages/Aspire.Pomelo.EntityFrameworkCore.MySql) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/oracle-entity-framework-component.md

@@ -1,7 +1,7 @@
 ---
 title: Oracle Entity Framework Component
 description: Oracle Entity Framework Component
-ms.date: 06/28/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire Oracle Entity Framework Component
@@ -10,7 +10,7 @@ In this article, you learn how to use the The .NET Aspire Oracle Entity Framewor
 
 ## Get started
 
-You need an Oracle database and connection string for accessing the database. To get started with the The .NET Aspire Oracle Entity Framework Core component, install the [Aspire.Oracle.EntityFrameworkCore](https://www.nuget.org/packages/Aspire.Oracle.EntityFrameworkCore) NuGet package.
+You need an Oracle database and connection string for accessing the database. To get started with the The .NET Aspire Oracle Entity Framework Core component, install the [Aspire.Oracle.EntityFrameworkCore](https://www.nuget.org/packages/Aspire.Oracle.EntityFrameworkCore) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 
@@ -59,7 +59,7 @@ builder.EnrichOracleDatabaseDbContext<MyDbContext>();
 
 ## App host usage
 
-To model the Oracle server resource in the app host, install the [Aspire.Hosting.Oracle](https://www.nuget.org/packages/Aspire.Hosting.Oracle) NuGet package.
+To model the Oracle server resource in the app host, install the [Aspire.Hosting.Oracle](https://www.nuget.org/packages/Aspire.Hosting.Oracle) NuGet package in the [app host](xref:aspire/app-host) project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/postgresql-component.md

@@ -1,7 +1,7 @@
 ---
 title: .NET Aspire PostgreSQL component
 description: This article describes the .NET Aspire PostgreSQL component.
-ms.date: 06/28/2024
+ms.date: 07/17/2024
 ms.topic: how-to
 ---
 
@@ -11,7 +11,7 @@ In this article, you learn how to use the .NET Aspire PostgreSQL component. The
 
 ## Get started
 
-To get started with the .NET Aspire PostgreSQL component, install the [Aspire.Npgsql](https://www.nuget.org/packages/Aspire.Npgsql) NuGet package.
+To get started with the .NET Aspire PostgreSQL component, install the [Aspire.Npgsql](https://www.nuget.org/packages/Aspire.Npgsql) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/postgresql-entity-framework-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire PostgreSQL Entity Framework Core component
 description: This article describes the .NET Aspire PostgreSQL Entity Framework Core component.
 ms.topic: how-to
-ms.date: 06/28/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire PostgreSQL Entity Framework Core component
@@ -24,7 +24,7 @@ PostgreSQL is a powerful, open source, object-relational database system. The .N
 
 ## Get started
 
-To get started with the .NET Aspire PostgreSQL Entity Framework Core component, install the [Aspire.Npgsql.EntityFrameworkCore.PostgreSQL](https://www.nuget.org/packages/Aspire.Npgsql.EntityFrameworkCore.PostgreSQL) NuGet package.
+To get started with the .NET Aspire PostgreSQL Entity Framework Core component, install the [Aspire.Npgsql.EntityFrameworkCore.PostgreSQL](https://www.nuget.org/packages/Aspire.Npgsql.EntityFrameworkCore.PostgreSQL) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/qdrant-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire Qdrant component
 description: This article describes the .NET Aspire Qdrant component.
 ms.topic: how-to
-ms.date: 06/03/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire Qdrant component
@@ -11,7 +11,7 @@ In this article, you learn how to use the .NET Aspire Qdrant component. Use this
 
 ## Get started
 
-To get started with the .NET Aspire Qdrant component, install the [Aspire.Qdrant.Client](https://www.nuget.org/packages/Aspire.Qdrant.Client) NuGet package.
+To get started with the .NET Aspire Qdrant component, install the [Aspire.Qdrant.Client](https://www.nuget.org/packages/Aspire.Qdrant.Client) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 
@@ -49,7 +49,7 @@ public class ExampleService(QdrantClient client)
 
 ## App host usage
 
-To model the Qdrant server resource in the app host, install the [Aspire.Hosting.Qdrant](https://www.nuget.org/packages/Aspire.Hosting.Qdrant) NuGet package.
+To model the Qdrant server resource in the app host, install the [Aspire.Hosting.Qdrant](https://www.nuget.org/packages/Aspire.Hosting.Qdrant) NuGet package in the [app host](xref:aspire/app-host) project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/sql-server-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire SQL Server component
 description: This article describes the .NET Aspire SQL Server component.
 ms.topic: how-to
-ms.date: 06/28/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire SQL Server component
@@ -21,7 +21,7 @@ In this article, you learn how to use the .NET Aspire SQL Server component. The
 
 ## Get started
 
-To get started with the .NET Aspire SQL Server component, install the [Aspire.Microsoft.Data.SqlClient](https://www.nuget.org/packages/Aspire.Microsoft.Data.SqlClient) NuGet package.
+To get started with the .NET Aspire SQL Server component, install the [Aspire.Microsoft.Data.SqlClient](https://www.nuget.org/packages/Aspire.Microsoft.Data.SqlClient) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/database/sql-server-entity-framework-component.md

@@ -2,7 +2,7 @@
 title: .NET Aspire SqlServer Entity Framework Core component
 description: This article describes the .NET Aspire SQL Server Entity Framework Core component.
 ms.topic: how-to
-ms.date: 06/28/2024
+ms.date: 07/17/2024
 ---
 
 # .NET Aspire SqlServer Entity Framework Core component
@@ -20,7 +20,7 @@ In this article, you learn how to use the .NET Aspire SqlServer Entity Framework
 
 ## Get started
 
-To get started with the .NET Aspire SQL Server Entity Framework Core component, install the [Aspire.Microsoft.EntityFrameworkCore.SqlServer](https://www.nuget.org/packages/Aspire.Microsoft.EntityFrameworkCore.SqlServer) NuGet package.
+To get started with the .NET Aspire SQL Server Entity Framework Core component, install the [Aspire.Microsoft.EntityFrameworkCore.SqlServer](https://www.nuget.org/packages/Aspire.Microsoft.EntityFrameworkCore.SqlServer) NuGet package in the consuming client project.
 
 ### [.NET CLI](#tab/dotnet-cli)
 

docs/fundamentals/app-host-overview.md

@@ -3,6 +3,7 @@ title: .NET Aspire orchestration overview
 description: Learn the fundamental concepts of .NET Aspire orchestration and explore the various APIs to express resource references.
 ms.date: 06/03/2024
 ms.topic: overview
+uid: aspire/app-host
 ---
 
 # .NET Aspire orchestration overview