Skip to content

Commit e7b8f3e

Browse files
Fix indefinite article usage with "Aspire" throughout documentation (#5190)
* Initial plan * Replace "a Aspire" with "an Aspire" throughout documentation Co-authored-by: alistairmatthews <41286777+alistairmatthews@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: alistairmatthews <41286777+alistairmatthews@users.noreply.github.com>
1 parent 5910555 commit e7b8f3e

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+121
-121
lines changed

docs/app-host/withdockerfile.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ With Aspire it's possible to specify a _Dockerfile_ to build when the [AppHost](
1111
These two methods serve different purposes:
1212

1313
- **<xref:Aspire.Hosting.ContainerResourceBuilderExtensions.AddDockerfile%2A>**: Creates a new container resource from an existing Dockerfile. Use this when you want to add a custom containerized service to your app model.
14-
- **<xref:Aspire.Hosting.ContainerResourceBuilderExtensions.WithDockerfile%2A>**: Customizes an existing container resource (like a database or cache) to use a different Dockerfile. Use this when you want to modify the default container image for a Aspire component.
14+
- **<xref:Aspire.Hosting.ContainerResourceBuilderExtensions.WithDockerfile%2A>**: Customizes an existing container resource (like a database or cache) to use a different Dockerfile. Use this when you want to modify the default container image for an Aspire component.
1515

1616
Both methods expect an existing Dockerfile in the specified context path—neither method creates a Dockerfile for you.
1717

docs/azure/container-app-jobs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -188,5 +188,5 @@ builder.AddExecutable("data-script", "python", ".", "process_data.py")
188188

189189
- [Configure Azure Container Apps environments](configure-aca-environments.md).
190190
- [Azure Container Apps Jobs documentation](/azure/container-apps/jobs).
191-
- [Deploy a Aspire project to Azure Container Apps](../deployment/azure/aca-deployment.md).
191+
- [Deploy an Aspire project to Azure Container Apps](../deployment/azure/aca-deployment.md).
192192
- [Customize Azure resources](customize-azure-resources.md).

docs/azure/customize-azure-resources.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ uid: dotnet/aspire/integrations/customize-azure-resources
77

88
# Customize Azure resources
99

10-
If you're using Azure to host resources for a Aspire solution, you have granular control over those resources. You can either let Aspire configure them if the default properties suit your needs, or override defaults to control their behavior. Let's examine how you can customize your Azure infrastructure from Aspire code.
10+
If you're using Azure to host resources for an Aspire solution, you have granular control over those resources. You can either let Aspire configure them if the default properties suit your needs, or override defaults to control their behavior. Let's examine how you can customize your Azure infrastructure from Aspire code.
1111

1212
The Azure SDK for .NET provides the [📦 Azure.Provisioning](https://www.nuget.org/packages/Azure.Provisioning) NuGet package and a suite of service-specific [Azure provisioning packages](https://www.nuget.org/packages?q=owner%3A+azure-sdk+description%3A+declarative+resource+provisioning&sortby=relevance). These Azure provisioning libraries make it easy to declaratively specify Azure infrastructure natively in .NET. Their APIs enable you to write object-oriented infrastructure in C#, resulting in Bicep. [Bicep is a domain-specific language (DSL)](/azure/azure-resource-manager/bicep/overview) for deploying Azure resources declaratively.
1313

@@ -81,7 +81,7 @@ The preceding code:
8181
- Adds a project named `worker` to the builder.
8282
- Chains a call to <xref:Aspire.Hosting.ResourceBuilderExtensions.WithEnvironment*> to set the `ACR_REGISTRY_NAME` environment variable in the project to the value of the `registryName` output.
8383

84-
The functionality demonstrates how to add Azure infrastructure to your AppHost project, even if the Azure service isn't directly exposed as a Aspire integration. It further shows how to flow the output of the Azure Container Registry into the environment of a dependent project.
84+
The functionality demonstrates how to add Azure infrastructure to your AppHost project, even if the Azure service isn't directly exposed as an Aspire integration. It further shows how to flow the output of the Azure Container Registry into the environment of a dependent project.
8585

8686
Consider the resulting Bicep file:
8787

docs/azure/integrations-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -334,4 +334,4 @@ To configure the Azure Container App environment, see [Configure Azure Container
334334

335335
When you publish your app, the Azure provisioning generated Bicep is used by the Azure Developer CLI to create the Azure resources in your Azure subscription. Aspire outputs a [publishing manifest](../deployment/manifest-format.md), that's also a vital part of the publishing process. The Azure Developer CLI is a command-line tool that provides a set of commands to manage Azure resources.
336336

337-
For more information on publishing and deployment, see [Deploy a Aspire project to Azure Container Apps using the Azure Developer CLI (in-depth guide)](../deployment/azure/aca-deployment-azd-in-depth.md).
337+
For more information on publishing and deployment, see [Deploy an Aspire project to Azure Container Apps using the Azure Developer CLI (in-depth guide)](../deployment/azure/aca-deployment-azd-in-depth.md).

docs/caching/stackexchange-redis-caching-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.date: 02/05/2025
1010

1111
With Aspire, there are several ways to use caching in your applications. One popular option is to use [Stack Exchange Redis](https://stackexchange.github.io/StackExchange.Redis), which is a high-performance data store that can be used to store frequently accessed data. This article provides an overview of Stack Exchange Redis caching and links to resources that help you use it in your applications.
1212

13-
To use multiple Redis caching integrations in your application, see [Tutorial: Implement caching with Aspire integrations](caching-integrations.md). If you're interested in using the Redis Cache for Azure, see [Tutorial: Deploy a Aspire project with a Redis Cache to Azure](caching-integrations-deployment.md).
13+
To use multiple Redis caching integrations in your application, see [Tutorial: Implement caching with Aspire integrations](caching-integrations.md). If you're interested in using the Redis Cache for Azure, see [Tutorial: Deploy an Aspire project with a Redis Cache to Azure](caching-integrations-deployment.md).
1414

1515
## Redis serialization protocol (RESP)
1616

docs/community-toolkit/dapr.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: NET Aspire Dapr integration
3-
description: Learn how to use the Aspire Dapr integration, which can configure and orchestrate Dapr from a Aspire AppHost project.
3+
description: Learn how to use the Aspire Dapr integration, which can configure and orchestrate Dapr from an Aspire AppHost project.
44
ms.date: 05/12/2025
55
uid: frameworks/dapr
66
---
@@ -74,7 +74,7 @@ For more information, see [dotnet add package](/dotnet/core/tools/dotnet-add-pac
7474

7575
Dapr uses the [sidecar pattern](https://docs.dapr.io/concepts/dapr-services/sidecar/). The Dapr sidecar runs alongside your app as a lightweight, portable, and stateless HTTP server that listens for incoming HTTP requests from your app.
7676

77-
To add a sidecar to a Aspire resource, call the `WithDaprSidecar` method on it. The `appId` parameter is the unique identifier for the Dapr application, but it's optional. If you don't provide an `appId`, the parent resource name is used instead.
77+
To add a sidecar to an Aspire resource, call the `WithDaprSidecar` method on it. The `appId` parameter is the unique identifier for the Dapr application, but it's optional. If you don't provide an `appId`, the parent resource name is used instead.
7878

7979
:::code language="csharp" source="snippets/Dapr/Dapr.AppHost/AppHost.cs" range="1-7" highlight="7":::
8080

@@ -86,7 +86,7 @@ The `WithDaprSidecar` method offers overloads to configure your Dapr sidecar opt
8686

8787
### Complete Dapr AppHost example
8888

89-
Putting everything together, consider the following example of a Aspire AppHost project that includes:
89+
Putting everything together, consider the following example of an Aspire AppHost project that includes:
9090

9191
- A backend API service that declares a Dapr sidecar with defaults.
9292
- A web frontend project that declares a Dapr sidecar with specific options, such as explict ports.

docs/database/connect-to-existing-database.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
2-
title: Connect a Aspire microservice to an existing database
3-
description: Learn how to configure a Aspire solution with a connection to an existing database that isn't hosted in a Aspire container.
2+
title: Connect an Aspire microservice to an existing database
3+
description: Learn how to configure an Aspire solution with a connection to an existing database that isn't hosted in an Aspire container.
44
ms.date: 03/13/2025
55
ms.topic: tutorial
66
uid: database/connect-to-existing-database
77
zone_pivot_groups: entity-framework-client-integration
88
---
99

10-
# Tutorial: Connect a Aspire microservice to an existing database
10+
# Tutorial: Connect an Aspire microservice to an existing database
1111

1212
Aspire is designed to make it easy and quick to develop cloud-native solutions. It uses containers to host the services, such as databases, that underpin each microservice. However, if you want your microservice to query a database that already exists, you must connect your microservice to it instead of creating a database container whenever you run the solution.
1313

14-
In this tutorial, you create a Aspire solution with an API that connects to an existing database. You'll learn how to:
14+
In this tutorial, you create an Aspire solution with an API that connects to an existing database. You'll learn how to:
1515

1616
> [!div class="checklist"]
1717
>

docs/database/entity-framework-core-integration-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -574,7 +574,7 @@ In EF Core a context is relatively quick to create and dispose of so most applic
574574

575575
Context pooling is a feature of EF Core. Contexts are created as normal but, when you dispose of one, it isn't destroyed but reset and stored in a pool. The next time your code creates a context, the stored one is returned to avoid the extra overhead of creating a new one.
576576

577-
In a Aspire consuming project, there are three ways to use context pooling:
577+
In an Aspire consuming project, there are three ways to use context pooling:
578578

579579
- Use the Aspire `Add\<DatabaseSystem\>DbContext` methods to create the context. These methods create a context pool automatically.
580580
- Call the EF Core <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContextPool*> method instead of the EF Core <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContext*> method.

docs/database/sql-server-integrations.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,12 +7,12 @@ ms.topic: tutorial
77

88
# Tutorial: Connect an ASP.NET Core app to SQL Server using Aspire and Entity Framework Core
99

10-
In this tutorial, you create an ASP.NET Core app that uses a Aspire Entity Framework Core SQL Server integration to connect to SQL Server to read and write support ticket data. [Entity Framework Core](/ef/core/) is a lightweight, extensible, open source object-relational mapper that enables .NET developers to work with databases using .NET objects. You'll learn how to:
10+
In this tutorial, you create an ASP.NET Core app that uses an Aspire Entity Framework Core SQL Server integration to connect to SQL Server to read and write support ticket data. [Entity Framework Core](/ef/core/) is a lightweight, extensible, open source object-relational mapper that enables .NET developers to work with databases using .NET objects. You'll learn how to:
1111

1212
> [!div class="checklist"]
1313
>
1414
> - Create a basic .NET app that is set up to use Aspire integrations
15-
> - Add a Aspire integration to connect to SQL Server
15+
> - Add an Aspire integration to connect to SQL Server
1616
> - Configure and use Aspire Component features to read and write from the database
1717
1818
[!INCLUDE [aspire-prereqs](../includes/aspire-prereqs.md)]
@@ -167,4 +167,4 @@ Let's examine how the data volume changes the behavior of the solution:
167167

168168
- [Aspire with SQL Database deployment](sql-server-integration-deployment.md)
169169
- [Aspire deployment via Azure Container Apps](../deployment/azure/aca-deployment.md)
170-
- [Deploy a Aspire project using GitHub Actions](../deployment/azure/aca-deployment-github-actions.md)
170+
- [Deploy an Aspire project using GitHub Actions](../deployment/azure/aca-deployment-github-actions.md)

docs/deployment/aspire-deploy/aca-deployment-aspire-cli.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ ms.date: 09/25/2025
55
ai-usage: ai-assisted
66
---
77

8-
# Deploy a Aspire project to Azure Container Apps using Aspire CLI
8+
# Deploy an Aspire project to Azure Container Apps using Aspire CLI
99

10-
The [`aspire deploy`](../../cli-reference/aspire-deploy.md) CLI command provides a streamlined way to deploy Aspire applications directly to Azure Container Apps. This command automates the entire deployment process, from building container images to provisioning Azure infrastructure and deploying your applications. This article walks you through using the `aspire deploy` command to deploy a Aspire solution to Container Apps. You'll learn how to complete the following tasks:
10+
The [`aspire deploy`](../../cli-reference/aspire-deploy.md) CLI command provides a streamlined way to deploy Aspire applications directly to Azure Container Apps. This command automates the entire deployment process, from building container images to provisioning Azure infrastructure and deploying your applications. This article walks you through using the `aspire deploy` command to deploy an Aspire solution to Container Apps. You'll learn how to complete the following tasks:
1111

1212
> [!div class="checklist"]
1313
>
@@ -47,9 +47,9 @@ This command opens a web browser for you to sign in with your Azure credentials.
4747
- [Sign in with Azure CLI](/cli/azure/authenticate-azure-cli).
4848
- [The `aspire deploy` command reference](/dotnet/aspire/cli-reference/aspire-deploy).
4949

50-
## Create a Aspire project
50+
## Create an Aspire project
5151

52-
As a starting point, this article assumes you've created a Aspire project from the **Aspire Starter Application** template. For more information, see [Quickstart: Build your first Aspire project](../../get-started/build-your-first-aspire-app.md).
52+
As a starting point, this article assumes you've created an Aspire project from the **Aspire Starter Application** template. For more information, see [Quickstart: Build your first Aspire project](../../get-started/build-your-first-aspire-app.md).
5353

5454
To configure your project for Azure Container Apps deployment, add a package reference to your AppHost project that includes the [`📦Aspire.Hosting.Azure.AppContainers](https://www.nuget.org/packages/Aspire.Hosting.Azure.AppContainers) NuGet package:
5555

0 commit comments

Comments
 (0)