Fix indefinite article usage with "Aspire" throughout documentation #5190
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Co-authored-by: alistairmatthews <41286777+alistairmatthews@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Fix indefinite article usage with Aspire
Fix indefinite article usage with "Aspire" throughout documentation
Oct 9, 2025
Copilot finished work on behalf of
alistairmatthews
October 9, 2025 10:32
alistairmatthews
approved these changes
Oct 9, 2025
Contributor
alistairmatthews
left a comment
alistairmatthews
left a comment
There was a problem hiding this comment.
All changes look good.
IEvangelist
approved these changes
Oct 9, 2025
Member
IEvangelist
left a comment
IEvangelist
left a comment
There was a problem hiding this comment.
Looks good to me, we'll 
- thank you 🙏
Contributor
There was a problem hiding this comment.
Pull Request Overview
This PR fixes a grammatical error where "a Aspire" was incorrectly used instead of "an Aspire" throughout the documentation. Following the English grammar rule that "an" is used before words beginning with a vowel sound, the indefinite article should be "an" when preceding "Aspire" since it begins with a vowel sound.
- Corrected 122 instances across 46 markdown files from "a Aspire" to "an Aspire"
- Updated article titles, descriptions, and content to use proper grammar
- Fixed references in deployment guides, tutorials, and integration documentation
Reviewed Changes
Copilot reviewed 46 out of 46 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| docs/whats-new/dotnet-docs-aspire-mod1.md | Fixed article title references in what's new documentation |
| docs/whats-new/dotnet-docs-aspire-mod0.md | Corrected deployment guide titles and article references |
| docs/whats-new/dotnet-aspire-9.1.md | Updated reference to deployment documentation |
| docs/troubleshooting/name-is-already-in-use.md | Fixed indefinite article in troubleshooting guide |
| docs/troubleshooting/allow-unsecure-transport.md | Corrected grammar in symptoms description |
| docs/testing/write-your-first-test.md | Fixed indefinite article in test project creation instructions |
| docs/storage/azure-storage-integrations.md | Corrected grammar in sample solution creation section |
| docs/service-discovery/overview.md | Fixed indefinite article in service discovery overview |
| docs/get-started/build-your-first-aspire-app.md | Updated quickstart guide grammar and checklist items |
| docs/get-started/build-aspire-apps-with-python.md | Fixed title, description, and content grammar for Python integration |
| docs/get-started/build-aspire-apps-with-nodejs.md | Corrected title, description, and content for Node.js integration |
| docs/fundamentals/telemetry.md | Fixed indefinite article in telemetry overview |
| docs/fundamentals/setup-tooling.md | Corrected alt text for debugging screenshot |
| docs/fundamentals/service-defaults.md | Fixed grammar in service defaults explanation |
| docs/fundamentals/persist-data-volumes.md | Updated data persistence documentation grammar |
| docs/fundamentals/orchestrate-resources.md | Corrected resource naming conventions section |
| docs/fundamentals/networking-overview.md | Fixed service binding description |
| docs/fundamentals/integrations-overview.md | Updated integration descriptions and versioning text |
| docs/fundamentals/dashboard/explore.md | Corrected dashboard exploration guide grammar |
| docs/fundamentals/dashboard/copilot.md | Fixed GitHub Copilot requirements section |
| docs/fundamentals/aspire-sdk-templates.md | Updated template descriptions and creation instructions |
| docs/frameworks/orleans.md | Fixed Orleans integration title, description, and content |
| docs/extensibility/custom-hosting-integration.md | Corrected custom resource section heading |
| docs/extensibility/custom-client-integration.md | Updated client integration overview and summary |
| docs/diagnostics/overview.md | Fixed diagnostic warning description |
| docs/diagnostics/aspire003.md | Corrected warning title and description |
| docs/deployment/manifest-format.md | Updated manifest generation and connection string descriptions |
| docs/deployment/azd/customize-deployments.md | Fixed deployment customization references |
| docs/deployment/azd/aca-deployment.md | Corrected main deployment guide title and content |
| docs/deployment/azd/aca-deployment-github-actions.md | Updated GitHub Actions deployment tutorial |
| docs/deployment/azd/aca-deployment-azd-in-depth.md | Fixed in-depth deployment guide title and content |
| docs/deployment/aspire-deploy/sql-server-integration-deployment.md | Corrected SQL Server deployment tutorial title and references |
| docs/deployment/aspire-deploy/caching-integrations-deployment.md | Updated Redis Cache deployment tutorial |
| docs/deployment/aspire-deploy/azure-security-best-practices.md | Fixed security best practices documentation |
| docs/deployment/aspire-deploy/application-insights.md | Corrected Application Insights integration reference |
| docs/deployment/aspire-deploy/aca-deployment-visual-studio.md | Updated Visual Studio deployment guide |
| docs/deployment/aspire-deploy/aca-deployment-aspire-cli.md | Fixed Aspire CLI deployment documentation |
| docs/database/sql-server-integrations.md | Corrected SQL Server integration tutorial |
| docs/database/entity-framework-core-integration-overview.md | Fixed EF Core integration documentation |
| docs/database/connect-to-existing-database.md | Updated existing database connection tutorial |
| docs/community-toolkit/dapr.md | Corrected Dapr integration title, description, and content |
| docs/caching/stackexchange-redis-caching-overview.md | Fixed Redis caching overview reference |
| docs/azure/integrations-overview.md | Updated Azure integrations deployment reference |
| docs/azure/customize-azure-resources.md | Fixed Azure resource customization documentation |
| docs/azure/container-app-jobs.md | Corrected Container App Jobs reference |
| docs/app-host/withdockerfile.md | Updated Dockerfile integration explanation |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR corrects the grammatical error where "a Aspire" was used instead of "an Aspire" throughout the documentation. Since the product name was changed from ".NET Aspire" to "Aspire", the indefinite article should be "an" (used before words beginning with a vowel sound) rather than "a" (used before words beginning with a consonant sound).
Changes
Updated 122 instances across 46 markdown files to use the correct indefinite article "an" before "Aspire".
Examples of corrections:
❌ "Project is a Aspire AppHost project"
✅ "Project is an Aspire AppHost project"
❌ "Create a Aspire project using the template"
✅ "Create an Aspire project using the template"
❌ "Add a Aspire integration to connect to SQL Server"
✅ "Add an Aspire integration to connect to SQL Server"
❌ "Key elements of a Aspire custom resource"
✅ "Key elements of an Aspire custom resource"
Affected Areas
docs/diagnostics/)docs/get-started/)docs/extensibility/)docs/database/)docs/deployment/)docs/fundamentals/)docs/testing/)docs/whats-new/)Fixes #[issue_number]
Original prompt
💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.
Internal previews
Toggle expand/collapse
Note
This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select OpenPublishing.Build Details within checks.