Repository navigation
Propagate the API Reference Astro component - #1849
Merged
David Pine (IEvangelist) merged 10 commits intoOct 13, 2026
Merged
David Pine (IEvangelist) merged 10 commits into
David Pine (IEvangelist) merged 10 commits into
Conversation
![aspire-repo-bot[bot]](https://avatars.githubusercontent.com/in/3085065?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
One or more issues must be addressed before approval.
10 open findings
What changed in this PR
Propagates the existing ApiReference component across Aspire documentation, expanding language-aware API links beyond Get Started for issue #1848.
Changes:
- Replaces inline API names with language-aware references.
- Extends coverage across integration, deployment, testing, architecture, dashboard, and diagnostic pages.
- Updates selected Japanese documentation.
Static review identified incorrect API targets and substitutions of literal command values. Upstream-source and browser validation were not run.
| File | Description |
|---|---|
| src/frontend/src/content/docs/whats-new/aspire-9-1.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/testing/write-your-first-test.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/testing/advanced-scenarios.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/testing/accessing-resources.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-init.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-docs-api-search.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/testing/write-your-first-test.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/testing/accessing-resources.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/get-started/troubleshooting.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/get-started/resource-mcp-servers.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/get-started/faq.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/get-started/aspire-vscode-extension.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/get-started/aspire-mcp-server.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/fundamentals/service-discovery.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/fundamentals/http-commands.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/fundamentals/custom-resource-commands.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/extensibility/multi-language-integration-authoring.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/extensibility/interaction-service.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/extensibility/custom-resources.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/architecture/resource-publishing.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/architecture/resource-hierarchies.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/architecture/resource-examples.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/architecture/resource-api-patterns.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/app-host/resource-lifetimes.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/ja/app-host/container-registry.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/observability/seq/seq-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/messaging/rabbitmq/rabbitmq-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/messaging/nats/nats-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/messaging/nats/nats-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/messaging/lavinmq/lavinmq-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/messaging/apache-kafka/apache-kafka-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/frameworks/wpf-winforms.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/frameworks/rust/rust-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/frameworks/perl/perl-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/frameworks/orleans.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/frameworks/java/java-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/frameworks/go/go-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/frameworks/dotnet/dotnet-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/frameworks/deno/deno-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/frameworks/bun-apps.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/dotnet/maui.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/dotnet/csharp-file-based-apps.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/dotnet/blazor-hosting.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/dotnet/blazor-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/dotnet/blazor-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/devtools/mailpit/mailpit-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/devtools/goff/goff-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/devtools/flagd/flagd-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/devtools/dab/dab-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/devtools/browser-logs.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/surrealdb/surrealdb-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/surrealdb/surrealdb-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/sqlite/sqlite-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/sqlite/sqlite-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/sqlite/sqlite-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/sql-server/sql-server-extensions.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/ravendb/ravendb-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/ravendb/ravendb-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/mysql/mysql-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/mysql/mysql-extensions.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/mongodb/mongodb-extensions.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/milvus/milvus-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/meilisearch/meilisearch-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/meilisearch/meilisearch-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/kurrentdb/kurrentdb-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/elasticsearch/elasticsearch-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/elasticsearch/elasticsearch-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/efcore/sql-server/sql-server-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/efcore/seed-database.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/efcore/postgres/postgresql-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/efcore/mysql/mysql-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/efcore/mongodb/mongodb-efcore-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/efcore/azure-sql/azure-sql-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/clickhouse/clickhouse-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/databases/clickhouse/clickhouse-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/custom-integrations/secure-communication.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/user-assigned-identity.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/local-provisioning.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/container-app-jobs.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-web-pubsub/azure-web-pubsub-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-storage-tables/azure-storage-tables-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-storage-tables/azure-storage-tables-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-storage-queues/azure-storage-queues-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-storage-queues/azure-storage-queues-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-storage-datalake.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-storage-blobs/azure-storage-blobs-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-sql-database/azure-sql-database-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-sql-database/azure-sql-database-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-signalr/azure-signalr-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-postgresql/azure-postgresql-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-postgresql/azure-postgresql-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-functions/azure-functions-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-functions/azure-functions-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-default-credential.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-cosmos-db/azure-cosmos-db-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-container-registry/azure-container-registry-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-container-registry/azure-container-registry-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-connector-namespace.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-cache-redis/azure-cache-redis-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-app-service/azure-app-service-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-inference/azure-ai-inference-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/caching/valkey/valkey-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/caching/redis/redis-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/caching/redis-extensions.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/caching/redis-distributed/redis-distributed-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/caching/redis-distributed/redis-distributed-get-started.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/caching/garnet/garnet-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/ai/ollama/ollama-connect.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/integrations/ai/github-models/github-models-host.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/get-started/aspire-sdk.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/get-started/ai-coding-agents.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/get-started/add-aspire-existing-app.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/fundamentals/service-discovery.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/fundamentals/http-commands.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/fundamentals/environment-variables.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/fundamentals/container-networking.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/fundamentals/annotations-overview.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/extensibility/multi-language-integration-authoring.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/extensibility/interaction-service.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/extensibility/custom-resources.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireusersecrets001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireterminal001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireradius003.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireprojects001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireprocesscommand001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireprobes001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirepostgres001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirepipelines003.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirepersistence001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspiremcp001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirejavascript001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirehostingpython001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireextension001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspiredurabletask001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspiredotnettool001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspiredotnetproject001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspiredockerfilebuilder001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirecsharpapps001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirecosmosdb001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirecompute003.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirecompute002.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirecommand001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirecertificates001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspirebrowserlogs001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireblazor001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireazure003.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireazure002.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireacanaming001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/diagnostics/aspireacadomains001.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/deployment/pipelines.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/deployment/kubernetes/helm-charts.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/deployment/environments.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/deployment/deploy-with-aspire.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/deployment/custom-deployments.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/deployment/azure/azure-security-best-practices.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/deployment/azure/azure-developer-cli.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/deployment/azure/app-service.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/dashboard/terminals.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/dashboard/telemetry-after-deployment.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/dashboard/explore.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/dashboard/ephemeral-terminals.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/architecture/resource-publishing.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/architecture/resource-hierarchies.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/architecture/resource-examples.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/architecture/resource-api-patterns.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/architecture/multi-language-architecture.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/app-host/container-registry.mdx | Updated as part of this pull request. |
| src/frontend/src/content/docs/app-host/container-files.mdx | Updated as part of this pull request. |
🧠 Review effort: Balanced
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
David Pine (IEvangelist)
requested changes
Oct 11, 2026
David Pine (IEvangelist)
left a comment
David Pine (IEvangelist)
left a comment
Member
There was a problem hiding this comment.
Current-head follow-up - October 11, 2026
Request changes: the three P2 findings below still apply at ae29203cf46f8c86e2e5f2a11a06f02c76097b43. I checked the affected lines and the intervening changes against the originally reviewed head ef154fd1dd69480e21e4a9dbfaeada659c1fce1d. The AI coding agent and Japanese VS Code run-mode descriptions, and the Azure PostgreSQL language-labeled bullet, have been corrected; those locations are no longer requested changes.
The source verification and browser report preserved below were completed on October 9 against the original reviewed head. They are historical evidence, not a claim that browser tests or the full catalog audit were rerun on the latest revision.
[P2] Keep the Event Hubs configuration reference on the Event Hubs API
src/frontend/src/content/docs/integrations/cloud/azure/azure-event-hubs/azure-event-hubs-host.mdx:407
This reference resolves to YARP's WithConfiguration, not the Event Hubs emulator method described by the preceding sample. The YARP API takes IResourceBuilder<YarpResource> and Action<IYarpConfigurationBuilder>; Event Hubs takes IResourceBuilder<AzureEventHubsEmulatorResource> and Action<JsonNode>. In TypeScript mode this also links to the available YARP withConfiguration API while the sentence says it is unavailable. Keep the literal WithConfiguration here, or use a C#-only link to AzureEventHubsExtensions.WithConfiguration, rather than selecting an unrelated API to obtain a TypeScript target. Source evidence: microsoft/aspire at 006dcf0f47684cb65f1f0a530ba383d4f09c30c2, src/Aspire.Hosting.Azure.EventHubs/api/Aspire.Hosting.Azure.EventHubs.cs:29 and src/Aspire.Hosting.Yarp/api/Aspire.Hosting.Yarp.cs:61.
[P2] Do not replace the literal run launch mode with an AppHost method
src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx:90
Here run is a VS Code start-tool mode, not an AppHost API reference. With C# selected, this now reads 'Start a discovered AppHost in RunAsync or debug mode', but the tool accepts only the literal strings run and debug and rejects RunAsync. Restore run here and in the CLI command list in whats-new/aspire-9-2.mdx:498; both describe command/mode strings, not method calls. The corresponding AI coding agent and Japanese VS Code descriptions have already been fixed in the subsequent commits. Source evidence: microsoft/aspire at 006dcf0f47684cb65f1f0a530ba383d4f09c30c2, extension/src/lm/appHostLifecycleToolContracts.ts:18,217-218 and extension/src/dcp/types.ts:369.
[P2] Keep explicitly TypeScript references independent of the language preference
src/frontend/src/content/docs/deployment/kubernetes/persistent-volumes.mdx:104
This cell is explicitly under the TypeScript heading, but ApiReference follows the global AppHost language preference. Selecting C# therefore changes the TypeScript entry from withAccessMode to WithAccessMode and sends its link to the C# reference. Keep a fixed TypeScript name/link in language-specific columns and prose. The same issue occurs in this page's 'their TypeScript equivalents' sentence at line 232, customize-resources.mdx:816 (explicitly labeled '(TypeScript)'), and whats-new/aspire-13-2.mdx:417 ('in TypeScript'). A language-switching reference is appropriate for language-neutral prose, not a reference whose language is already specified. The Azure PostgreSQL introductory bullet has already been corrected by removing its fixed language label.
Original complete review - October 9 (historical; superseded locations identified above)
Review summary
Request changes: three P2 cross-reference regressions. Existing catalogs resolve all 1,342 newly added references, but resolution alone does not establish the correct context or language.
Reviewed head: ef154fd1dd69480e21e4a9dbfaeada659c1fce1d. Source pins: microsoft/aspire main@006dcf0f47684cb65f1f0a530ba383d4f09c30c2 and CommunityToolkit/Aspire main@853823c1dc2e2096b2844da72fd8f05f0a55b437; the two obsolete GitHub Models symbols were additionally checked against their catalog-pinned main-history source commit, as described below.
Phase A: 1,345 claims total - 1,340 verified, 2 verified with a historical-package nuance, 3 contextual cross-references contradicted, 0 unverifiable.
Phase B: 148 changed documentation routes exercised, including seven Japanese routes; eight representative pages checked in both AppHost languages. Two critical documentation issues were reproduced (both covered by the run-mode/command inline finding), with one sampled-coverage warning. The full independent tester report follows.
Phase A - Claim verification
Audited 1,342 newly added API-reference usages (498 distinct API members) in all 294 changed files, plus three contextual cross-reference claims. API-shape/source verdicts: 1340 verified, 2 verified with the historical-package nuance below, 0 unverifiable. Contextual verdicts: 3 contradicted claims, grouped into the inline findings.
Source pins:
microsoft/aspire,main,006dcf0f47684cb65f1f0a530ba383d4f09c30c2.CommunityToolkit/Aspire,main,853823c1dc2e2096b2844da72fd8f05f0a55b437.- GitHub Models 13.5.4:
microsoft/aspire, main-history ancestor9c1b401dd67746739044f68959cbf4d3d7af93a6, the source commit recorded in the PR catalog. This deprecated integration is absent at current main tip. Its two new references resolve in both catalogs and match that package source; absence from current main is not counted as a PR defect.
The API-reference unit checks pass, and every new usage resolves to both C# and TypeScript targets. These checks establish that the named APIs exist in the catalogs, not that each replacement is appropriate for its surrounding sentence.
[P2] Keep the Event Hubs configuration reference on the Event Hubs API
src/frontend/src/content/docs/integrations/cloud/azure/azure-event-hubs/azure-event-hubs-host.mdx:407
This reference resolves to YARP's WithConfiguration, not the Event Hubs emulator method described by the preceding sample. The YARP API takes IResourceBuilder<YarpResource> and Action<IYarpConfigurationBuilder>; Event Hubs takes IResourceBuilder<AzureEventHubsEmulatorResource> and Action<JsonNode>. In TypeScript mode this also links to the available YARP withConfiguration API while the sentence says it is unavailable. Keep the literal WithConfiguration here, or use a C#-only link to AzureEventHubsExtensions.WithConfiguration, rather than selecting an unrelated API to obtain a TypeScript target. Source evidence: microsoft/aspire at 006dcf0f47684cb65f1f0a530ba383d4f09c30c2, src/Aspire.Hosting.Azure.EventHubs/api/Aspire.Hosting.Azure.EventHubs.cs:29 and src/Aspire.Hosting.Yarp/api/Aspire.Hosting.Yarp.cs:61.
[P2] Do not replace the literal run launch mode with an AppHost method
src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx:90
Here run is a VS Code start-tool mode, not an AppHost API reference. With C# selected, this now reads 'Start a discovered AppHost in RunAsync or debug mode', but the tool accepts only the literal strings run and debug and rejects RunAsync. Restore run here and in get-started/ai-coding-agents.mdx:71, ja/get-started/aspire-vscode-extension.mdx:119, and the CLI command list in whats-new/aspire-9-2.mdx:498; the latter replacements likewise describe command strings, not method calls. Source evidence: microsoft/aspire at 006dcf0f47684cb65f1f0a530ba383d4f09c30c2, extension/src/lm/appHostLifecycleToolContracts.ts:18,217-218 and extension/src/dcp/types.ts:369.
[P2] Keep explicitly TypeScript references independent of the language preference
src/frontend/src/content/docs/deployment/kubernetes/persistent-volumes.mdx:104
This cell is explicitly under the TypeScript heading, but ApiReference follows the global AppHost language preference. Selecting C# therefore changes the TypeScript entry from withAccessMode to WithAccessMode and sends its link to the C# reference. Keep a fixed TypeScript name/link in language-specific columns and prose. The same issue occurs in this page's 'their TypeScript equivalents' sentence at line 232, azure-postgresql-get-started.mdx:27 and customize-resources.mdx:816 (both explicitly labeled '(TypeScript)'), and whats-new/aspire-13-2.mdx:417 ('in TypeScript'). A language-switching reference is appropriate for language-neutral prose, not a reference whose language is already specified.
Verified API members and source evidence (repeated usages grouped by canonical member)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.Azure.DataApiBuilder/api/CommunityToolkit.Aspire.Hosting.Azure.DataApiBuilder.cs
DataApiBuilderHostingExtension.AddDataAPIBuilder:14 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.Deno/api/CommunityToolkit.Aspire.Hosting.Deno.cs
DenoAppHostingExtensions.AddDenoApp:14 (2)DenoAppHostingExtensions.AddDenoTask:17 (2)DenoAppHostingExtensions.WithDenoPackageInstallation:20 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.Flagd/api/CommunityToolkit.Aspire.Hosting.Flagd.cs
FlagdBuilderExtensions.AddFlagd:14 (1)FlagdBuilderExtensions.WithBindFileSync:17 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.Floci/api/CommunityToolkit.Aspire.Hosting.Floci.cs
FlociHostingExtension.AddFlociAws:14 (1)FlociHostingExtension.AddFlociAzure:17 (1)FlociHostingExtension.AddFlociGcp:20 (1)FlociHostingExtension.WithConfigFile:23 (3)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.GoFeatureFlag/api/CommunityToolkit.Aspire.Hosting.GoFeatureFlag.cs
GoFeatureFlagBuilderExtensions.AddGoFeatureFlag:14 (1)GoFeatureFlagBuilderExtensions.WithGoffBindMount:20 (1)GoFeatureFlagBuilderExtensions.WithLogLevel:23 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.JavaScript.Extensions/api/CommunityToolkit.Aspire.Hosting.JavaScript.Extensions.cs
JavaScriptHostingExtensions.AddNxApp:20 (1)JavaScriptHostingExtensions.AddTurborepoApp:23 (1)JavaScriptHostingExtensions.WithMappedEndpointPort:32 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.K3s/api/CommunityToolkit.Aspire.Hosting.K3s.cs
K3sBuilderExtensions.WithAgentCount:17 (1)K3sBuilderExtensions.WithDataVolume:20 (1)K3sHelmBuilderExtensions.AddHelmRelease:50 (1)K3sHelmBuilderExtensions.WithHelmValue:53 (1)K3sHelmBuilderExtensions.WithHelmValuesFile:56 (1)K3sManifestBuilderExtensions.AddK8sManifest:62 (1)K3sServiceEndpointExtensions.AddServiceEndpoint:68 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.k6/api/CommunityToolkit.Aspire.Hosting.k6.cs
K6BuilderExtensions.AddK6:14 (1)K6BuilderExtensions.WithK6OtlpEnvironment:17 (1)K6BuilderExtensions.WithScript:20 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.Keycloak.Extensions/api/CommunityToolkit.Aspire.Hosting.Keycloak.Extensions.cs
KeycloakPostgresExtension.WithPostgres:14 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.Kind/api/CommunityToolkit.Aspire.Hosting.Kind.cs
KindManifestResourceBuilderExtensions.AddManifest:105 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.LavinMQ/api/CommunityToolkit.Aspire.Hosting.LavinMQ.cs
LavinMQHostingExtension.AddLavinMQ:14 (1)LavinMQHostingExtension.WithDataVolume:20 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.McpInspector/api/CommunityToolkit.Aspire.Hosting.McpInspector.cs
McpInspectorResourceBuilderExtensions.WithBun:37 (4)McpInspectorResourceBuilderExtensions.WithPnpm:44 (4)McpInspectorResourceBuilderExtensions.WithYarn:47 (6)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.Meilisearch/api/CommunityToolkit.Aspire.Hosting.Meilisearch.cs
MeilisearchBuilderExtensions.WithDataBindMount:17 (1)MeilisearchBuilderExtensions.WithDataVolume:20 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.MongoDB.Extensions/api/CommunityToolkit.Aspire.Hosting.MongoDB.Extensions.cs
MongoDBBuilderExtensions.WithDbGate:14 (1)MongoDBBuilderExtensions.WithDbx:17 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.MySql.Extensions/api/CommunityToolkit.Aspire.Hosting.MySql.Extensions.cs
MySqlBuilderExtensions.WithAdminer:14 (1)MySqlBuilderExtensions.WithDbGate:17 (1)MySqlBuilderExtensions.WithDbx:20 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.Ollama/api/CommunityToolkit.Aspire.Hosting.Ollama.cs
OllamaResourceBuilderExtensions.AddHuggingFaceModel:20 (1)OllamaResourceBuilderExtensions.AddModel:23 (1)OllamaResourceBuilderExtensions.AddOllama:29 (1)OllamaResourceBuilderExtensions.WithGPUSupport:41 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.Perl/api/CommunityToolkit.Aspire.Hosting.Perl.cs
PerlAppResourceBuilderExtensions.AddPerlApi:14 (1)PerlAppResourceBuilderExtensions.AddPerlExecutable:17 (1)PerlAppResourceBuilderExtensions.AddPerlModule:20 (1)PerlAppResourceBuilderExtensions.AddPerlScript:23 (1)PerlAppResourceBuilderExtensions.WithCarton:26 (1)PerlAppResourceBuilderExtensions.WithCpanMinus:30 (2)PerlAppResourceBuilderExtensions.WithLocalLib:34 (2)PerlAppResourceBuilderExtensions.WithPackage:38 (1)PerlAppResourceBuilderExtensions.WithPerlCertificateTrust:51 (1)PerlAppResourceBuilderExtensions.WithPerlbrewEnvironment:46 (1)PerlAppResourceBuilderExtensions.WithPerlbrew:42 (1)PerlAppResourceBuilderExtensions.WithProjectDependencies:55 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.PostgreSQL.Extensions/api/CommunityToolkit.Aspire.Hosting.PostgreSQL.Extensions.cs
PostgresBuilderExtensions.WithAdminer:14 (1)PostgresBuilderExtensions.WithDbGate:17 (1)PostgresBuilderExtensions.WithDbx:20 (1)PostgresDatabaseResourceBuilderExtensions.WithFlywayMigration:26 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.PowerShell/api/CommunityToolkit.Aspire.Hosting.PowerShell.cs
CommunityToolkit.Aspire.Hosting.PowerShell.DistributedApplicationBuilderExtensions.AddPowerShell:14 (1)CommunityToolkit.Aspire.Hosting.PowerShell.PowerShellRunspacePoolResourceBuilderExtensions.AddScript:35 (1)CommunityToolkit.Aspire.Hosting.PowerShell.PowerShellScriptResourceBuilderExtensions.WithArgs:63 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.RavenDB/api/CommunityToolkit.Aspire.Hosting.RavenDB.cs
RavenDBBuilderExtensions.AddDatabase:14 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.Redis.Extensions/api/CommunityToolkit.Aspire.Hosting.Redis.Extensions.cs
RedisBuilderExtensions.WithDbGate:14 (1)RedisBuilderExtensions.WithDbx:17 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects/api/CommunityToolkit.Aspire.Hosting.SqlDatabaseProjects.cs
SqlProjectBuilderExtensions.AddSqlProject:27 (1)SqlProjectBuilderExtensions.WithDacDeployOptions:41 (1)SqlProjectBuilderExtensions.WithDacpac:48 (1)SqlProjectBuilderExtensions.WithReference:55 (1)SqlProjectBuilderExtensions.WithSkipWhenDeployed:69 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.Sqlite/api/CommunityToolkit.Aspire.Hosting.Sqlite.cs
SqliteResourceBuilderExtensions.AddSqlite:14 (1)SqliteResourceBuilderExtensions.WithSqliteWeb:17 (2)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.SqlServer.Extensions/api/CommunityToolkit.Aspire.Hosting.SqlServer.Extensions.cs
SqlServerBuilderExtensions.WithAdminer:14 (1)SqlServerBuilderExtensions.WithDbGate:17 (1)SqlServerBuilderExtensions.WithDbx:20 (1)
CommunityToolkit/Aspire src/CommunityToolkit.Aspire.Hosting.SurrealDb/api/CommunityToolkit.Aspire.Hosting.SurrealDb.cs
SurrealDbBuilderExtensions.WithDataBindMount:31 (1)SurrealDbBuilderExtensions.WithLogLevel:41 (1)SurrealDbBuilderExtensions.WithSurrealist:47 (1)
microsoft/aspire src/Aspire.Hosting.Azure.AppConfiguration/api/Aspire.Hosting.Azure.AppConfiguration.cs
AzureAppConfigurationExtensions.AddAzureAppConfiguration:14 (1)AzureAppConfigurationExtensions.RunAsEmulator:17 (1)AzureAppConfigurationExtensions.WithDataBindMount:20 (1)AzureAppConfigurationExtensions.WithDataVolume:23 (1)
microsoft/aspire src/Aspire.Hosting.Azure.AppContainers/api/Aspire.Hosting.Azure.AppContainers.cs
AzureContainerAppExtensions.AddAzureContainerAppEnvironment:28 (9)AzureContainerAppExtensions.WithAcrPullIdentity:34 (2)AzureContainerAppExtensions.WithAzdResourceNaming:37 (2)AzureContainerAppExtensions.WithAzureLogAnalyticsWorkspace:40 (1)AzureContainerAppExtensions.WithCompactResourceNaming:44 (2)AzureContainerAppExtensions.WithUniqueResourceNaming:54 (2)ContainerAppExtensions.ConfigureCustomDomain:67 (3)ContainerAppExtensions.PublishAsAzureContainerAppJob:70 (4)ContainerAppExtensions.PublishAsScheduledAzureContainerAppJob:78 (4)
microsoft/aspire src/Aspire.Hosting.Azure.AppContainers/AzureContainerAppExtensions.cs
AzureContainerAppExtensions.AsExpress:1039 (3)
microsoft/aspire src/Aspire.Hosting.Azure.ApplicationInsights/api/Aspire.Hosting.Azure.ApplicationInsights.cs
AzureApplicationInsightsExtensions.AddAzureApplicationInsights:14 (1)
microsoft/aspire src/Aspire.Hosting.Azure.AppService/api/Aspire.Hosting.Azure.AppService.cs
AzureAppServiceComputeResourceExtensions.PublishAsAzureAppServiceWebsite:14 (4)AzureAppServiceComputeResourceExtensions.SkipEnvironmentVariableNameChecks:18 (1)AzureAppServiceEnvironmentExtensions.AddAzureAppServiceEnvironment:25 (4)AzureAppServiceEnvironmentExtensions.WithDeploymentSlot:46 (3)
microsoft/aspire src/Aspire.Hosting.Azure.CognitiveServices/api/Aspire.Hosting.Azure.CognitiveServices.cs
AzureOpenAIExtensions.AddAzureOpenAI:14 (1)AzureOpenAIExtensions.AddDeployment:18 (1)
microsoft/aspire src/Aspire.Hosting.Azure.ConnectorNamespace/AzureConnectorNamespaceExtensions.cs
AzureConnectorNamespaceExtensions.WithIdentityAccessPolicy:424 (1)
microsoft/aspire src/Aspire.Hosting.Azure.ContainerRegistry/api/Aspire.Hosting.Azure.ContainerRegistry.cs
AzureContainerRegistryExtensions.AddAzureContainerRegistry:14 (2)AzureContainerRegistryExtensions.GetAzureContainerRegistry:17 (3)AzureContainerRegistryExtensions.WithAzureContainerRegistry:21 (2)AzureContainerRegistryExtensions.WithPurgeTask:25 (3)
microsoft/aspire src/Aspire.Hosting.Azure.CosmosDB/api/Aspire.Hosting.Azure.CosmosDB.cs
AzureCosmosExtensions.AddAzureCosmosDB:52 (2)AzureCosmosExtensions.AddContainer:55 (1)AzureCosmosExtensions.AddCosmosDatabase:61 (1)AzureCosmosExtensions.RunAsEmulator:68 (4)AzureCosmosExtensions.RunAsPreviewEmulator:72 (4)AzureCosmosExtensions.WithAccessKeyAuthentication:75 (3)AzureCosmosExtensions.WithDataExplorer:82 (3)AzureCosmosExtensions.WithGatewayPort:91 (1)AzureCosmosExtensions.WithPartitionCount:94 (2)
microsoft/aspire src/Aspire.Hosting.Azure.CosmosDB/AzureCosmosDBExtensions.cs
AzureCosmosExtensions.RunAsClassicEmulator:93 (3)
microsoft/aspire src/Aspire.Hosting.Azure.EventHubs/api/Aspire.Hosting.Azure.EventHubs.cs
AzureEventHubsExtensions.AddAzureEventHubs:14 (1)AzureEventHubsExtensions.AddConsumerGroup:17 (1)AzureEventHubsExtensions.AddHub:23 (1)AzureEventHubsExtensions.WithConfigurationFile:32 (1)AzureEventHubsExtensions.WithHostPort:44 (1)
microsoft/aspire src/Aspire.Hosting.Azure.FrontDoor/api/Aspire.Hosting.Azure.FrontDoor.cs
AzureFrontDoorExtensions.AddAzureFrontDoor:14 (3)AzureFrontDoorExtensions.WithOrigin:17 (3)
microsoft/aspire src/Aspire.Hosting.Azure.Functions/api/Aspire.Hosting.Azure.Functions.cs
AzureFunctionsProjectResourceExtensions.AddAzureFunctionsProject:14 (2)AzureFunctionsProjectResourceExtensions.WithHostStorage:21 (1)DurableTaskResourceExtensions.AddDurableTaskScheduler:32 (3)DurableTaskResourceExtensions.AddTaskHub:36 (2)DurableTaskResourceExtensions.RunAsEmulator:40 (2)DurableTaskResourceExtensions.RunAsExisting:44 (2)DurableTaskResourceExtensions.WithTaskHubName:52 (1)
microsoft/aspire src/Aspire.Hosting.Azure.KeyVault/api/Aspire.Hosting.Azure.KeyVault.cs
AzureKeyVaultResourceExtensions.AddAzureKeyVault:14 (1)AzureKeyVaultResourceExtensions.AddSecret:17 (1)AzureKeyVaultResourceExtensions.GetSecret:35 (2)
microsoft/aspire src/Aspire.Hosting.Azure.Kubernetes/api/Aspire.Hosting.Azure.Kubernetes.cs
AzureCertManagerExtensions.AddCertManager:14 (1)AzureKubernetesEnvironmentExtensions.AddAzureKubernetesEnvironment:20 (7)AzureKubernetesEnvironmentExtensions.AddLoadBalancer:23 (2)AzureKubernetesEnvironmentExtensions.AddNodePool:26 (1)AzureKubernetesEnvironmentExtensions.WithSystemNodePool:38 (4)AzureKubernetesEnvironmentExtensions.WithWorkloadIdentity:41 (1)AzureKubernetesIngressExtensions.AddGateway:47 (1)AzureKubernetesIngressExtensions.AddHelmChart:50 (1)AzureKubernetesPersistentVolumeExtensions.AddPersistentVolume:66 (2)
microsoft/aspire src/Aspire.Hosting.Azure.Kusto/api/Aspire.Hosting.Azure.Kusto.cs
AzureKustoBuilderExtensions.AddAzureKustoCluster:14 (1)AzureKustoBuilderExtensions.AddReadWriteDatabase:17 (1)AzureKustoBuilderExtensions.WithHostPort:26 (1)
microsoft/aspire src/Aspire.Hosting.Azure.Network/api/Aspire.Hosting.Azure.Network.cs
AzureNatGatewayExtensions.AddNatGateway:14 (3)AzureNatGatewayExtensions.WithPublicIPAddress:17 (1)AzureNetworkSecurityGroupExtensions.AddNetworkSecurityGroup:23 (3)AzureNetworkSecurityGroupExtensions.WithSecurityRule:26 (2)AzureNetworkSecurityPerimeterExtensions.AddNetworkSecurityPerimeter:32 (1)AzureNetworkSecurityPerimeterExtensions.WithAccessRule:35 (1)AzureNetworkSecurityPerimeterExtensions.WithNetworkSecurityPerimeter:38 (1)AzurePrivateEndpointExtensions.AddPrivateEndpoint:45 (5)AzurePublicIPAddressExtensions.AddPublicIPAddress:51 (1)AzureVirtualNetworkExtensions.AddAzureVirtualNetwork:57 (5)AzureVirtualNetworkExtensions.AddSubnet:63 (4)AzureVirtualNetworkExtensions.AllowInbound:69 (3)AzureVirtualNetworkExtensions.AllowOutbound:72 (3)AzureVirtualNetworkExtensions.DenyInbound:75 (3)AzureVirtualNetworkExtensions.DenyOutbound:78 (3)AzureVirtualNetworkExtensions.WithDelegatedSubnet:81 (4)AzureVirtualNetworkExtensions.WithNatGateway:85 (3)AzureVirtualNetworkExtensions.WithNetworkSecurityGroup:88 (1)AzureVirtualNetworkExtensions.WithServiceDelegation:91 (1)
microsoft/aspire src/Aspire.Hosting.Azure.OperationalInsights/api/Aspire.Hosting.Azure.OperationalInsights.cs
AzureLogAnalyticsWorkspaceExtensions.AddAzureLogAnalyticsWorkspace:14 (1)
microsoft/aspire src/Aspire.Hosting.Azure.PostgreSQL/api/Aspire.Hosting.Azure.PostgreSQL.cs
AzurePostgresExtensions.AddAzurePostgresFlexibleServer:14 (1)AzurePostgresExtensions.AddDatabase:17 (1)AzurePostgresExtensions.RunAsContainer:26 (2)AzurePostgresExtensions.WithPasswordAuthentication:29 (2)AzurePostgresExtensions.WithPostgresMcp:36 (1)
microsoft/aspire src/Aspire.Hosting.Azure.Redis/api/Aspire.Hosting.Azure.Redis.cs
AzureManagedRedisExtensions.AddAzureManagedRedis:14 (3)AzureManagedRedisExtensions.RunAsContainer:17 (2)AzureManagedRedisExtensions.WithAccessKeyAuthentication:20 (2)
microsoft/aspire src/Aspire.Hosting.Azure.Sandboxes/api/Aspire.Hosting.Azure.Sandboxes.cs
AzureSandboxesExtensions.PublishAsAzureSandbox:20 (2)AzureSandboxesExtensions.WithNoManagedIdentity:30 (1)AzureSandboxesExtensions.WithSystemAssignedIdentity:34 (1)AzureSandboxesExtensions.WithUserAssignedIdentity:38 (1)
microsoft/aspire src/Aspire.Hosting.Azure.Sandboxes/AzureSandboxesExtensions.cs
AzureSandboxesExtensions.WithAcrPullIdentity:285 (1)
microsoft/aspire src/Aspire.Hosting.Azure.Search/api/Aspire.Hosting.Azure.Search.cs
AzureSearchExtensions.AddAzureSearch:14 (1)
microsoft/aspire src/Aspire.Hosting.Azure.ServiceBus/api/Aspire.Hosting.Azure.ServiceBus.cs
AzureServiceBusExtensions.AddAzureServiceBus:14 (2)AzureServiceBusExtensions.AddServiceBusQueue:21 (1)AzureServiceBusExtensions.AddServiceBusSubscription:24 (1)AzureServiceBusExtensions.AddServiceBusTopic:27 (1)AzureServiceBusExtensions.RunAsEmulator:42 (1)AzureServiceBusExtensions.WithConfigurationFile:48 (1)AzureServiceBusExtensions.WithHostPort:51 (1)
microsoft/aspire src/Aspire.Hosting.Azure.SignalR/api/Aspire.Hosting.Azure.SignalR.cs
AzureSignalRExtensions.AddAzureSignalR:14 (1)AzureSignalRExtensions.RunAsEmulator:20 (1)
microsoft/aspire src/Aspire.Hosting.Azure.Sql/api/Aspire.Hosting.Azure.Sql.cs
AzureSqlExtensions.AddAzureSqlServer:14 (2)AzureSqlExtensions.AddDatabase:17 (3)AzureSqlExtensions.RunAsContainer:26 (5)AzureSqlExtensions.WithAdminDeploymentScriptStorage:30 (1)AzureSqlExtensions.WithAdminDeploymentScriptSubnet:34 (1)
microsoft/aspire src/Aspire.Hosting.Azure.Storage/api/Aspire.Hosting.Azure.Storage.cs
AzureStorageExtensions.AddAzureStorage:14 (5)AzureStorageExtensions.AddBlobContainer:17 (3)AzureStorageExtensions.AddBlobs:23 (2)AzureStorageExtensions.AddDataLakeFileSystem:29 (1)AzureStorageExtensions.AddDataLake:26 (1)AzureStorageExtensions.AddTables:38 (1)AzureStorageExtensions.RunAsEmulator:41 (6)AzureStorageExtensions.WithDataBindMount:50 (3)AzureStorageExtensions.WithDataVolume:53 (2)
microsoft/aspire src/Aspire.Hosting.Azure.WebPubSub/api/Aspire.Hosting.Azure.WebPubSub.cs
AzureWebPubSubExtensions.AddAzureWebPubSub:14 (1)AzureWebPubSubExtensions.AddEventHandler:17 (1)AzureWebPubSubExtensions.AddHub:23 (1)
microsoft/aspire src/Aspire.Hosting.Azure/api/Aspire.Hosting.Azure.cs
Azure.AzureUserAssignedIdentityExtensions.AddAzureUserAssignedIdentity:431 (1)AzureBicepResourceExtensions.AddBicepTemplateString:17 (1)AzureBicepResourceExtensions.AddBicepTemplate:14 (1)AzureBicepResourceExtensions.GetOutput:20 (2)AzureBicepResourceExtensions.WithParameter:38 (1)AzureProvisionerExtensions.AddAzureProvisioning:85 (28)AzureProvisioningResourceExtensions.ConfigureInfrastructure:115 (32)AzureResourceExtensions.ClearDefaultRoleAssignments:122 (7)AzureResourceExtensions.GetBicepIdentifier:126 (1)AzureResourceExtensions.PublishAsConnectionString:130 (1)ExistingAzureResourceExtensions.AsExisting:137 (24)ExistingAzureResourceExtensions.PublishAsExisting:168 (13)ExistingAzureResourceExtensions.RunAsExisting:200 (7)
microsoft/aspire src/Aspire.Hosting.Blazor/api/Aspire.Hosting.Blazor.cs
BlazorGatewayExtensions.AddBlazorGateway:15 (3)BlazorGatewayExtensions.AddBlazorWasmApp:18 (1)BlazorGatewayExtensions.AddBlazorWasmProject:21 (3)BlazorGatewayExtensions.AddDotnetProjectBlazorGateway:26 (3)
microsoft/aspire src/Aspire.Hosting.Browsers/api/Aspire.Hosting.Browsers.cs
BrowserLogsBuilderExtensions.WithBrowserLogs:16 (5)
microsoft/aspire src/Aspire.Hosting.DevTunnels/api/Aspire.Hosting.DevTunnels.cs
DevTunnelsResourceBuilderExtensions.AddDevTunnel:14 (1)DevTunnelsResourceBuilderExtensions.WithAnonymousAccess:27 (1)
microsoft/aspire src/Aspire.Hosting.DevTunnels/DevTunnelResourceBuilderExtensions.cs
DevTunnelsResourceBuilderExtensions.WithExpiration:389 (1)
microsoft/aspire src/Aspire.Hosting.Docker/api/Aspire.Hosting.Docker.cs
Docker.DockerComposeEnvironmentResource.GetHostAddressExpression:97 (3)DockerComposeAspireDashboardResourceBuilderExtensions.WithForwardedHeaders:14 (2)DockerComposeAspireDashboardResourceBuilderExtensions.WithHostPort:17 (1)DockerComposeEnvironmentExtensions.AddDockerComposeEnvironment:23 (4)DockerComposeEnvironmentExtensions.ConfigureComposeFile:26 (3)DockerComposeEnvironmentExtensions.ConfigureEnvFile:29 (4)DockerComposeEnvironmentExtensions.WithDashboard:32 (1)DockerComposeEnvironmentExtensions.WithProperties:38 (1)DockerComposeServiceExtensions.AsEnvironmentPlaceholder:44 (2)DockerComposeServiceExtensions.PublishAsDockerComposeService:53 (5)
microsoft/aspire src/Aspire.Hosting.Dotnet/api/Aspire.Hosting.Dotnet.cs
DotnetProjectHostingExtensions.AddDotnetProject:15 (5)
microsoft/aspire src/Aspire.Hosting.Dotnet/DotnetProjectHostingExtensions.cs
DotnetProjectHostingExtensions.WithBuildEnvironment:68 (3)
microsoft/aspire src/Aspire.Hosting.EntityFrameworkCore/api/Aspire.Hosting.EntityFrameworkCore.cs
EFMigrationResourceBuilderExtensions.PublishAsMigrationBundle:14 (1)EFMigrationResourceBuilderExtensions.PublishAsMigrationScript:17 (1)EFMigrationResourceBuilderExtensions.RunDatabaseUpdateOnStart:20 (1)EFResourceBuilderExtensions.AddEFMigrations:39 (1)
microsoft/aspire src/Aspire.Hosting.Foundry/api/Aspire.Hosting.Foundry.cs
AzureCognitiveServicesProjectExtensions.AddModelDeployment:56 (3)AzureCognitiveServicesProjectExtensions.AddProject:62 (3)AzureCognitiveServicesProjectExtensions.WithAppInsights:65 (2)AzureCognitiveServicesProjectExtensions.WithKeyVault:68 (2)FoundryExtensions.AddDeployment:78 (1)FoundryExtensions.AddFoundry:84 (5)FoundryExtensions.RunAsFoundryLocal:87 (7)FoundryExtensions.WithProperties:90 (1)HostedAgentResourceBuilderExtensions.AsHostedAgent:100 (3)PromptAgentBuilderExtensions.AddAISearchTool:127 (1)PromptAgentBuilderExtensions.AddCodeInterpreterTool:139 (1)PromptAgentBuilderExtensions.AddPromptAgent:157 (4)PromptAgentBuilderExtensions.AddWebSearchTool:163 (1)PromptAgentBuilderExtensions.WithTool:181 (1)
microsoft/aspire src/Aspire.Hosting.Foundry/Toolbox/FoundryToolboxBuilderExtensions.cs
FoundryToolboxBuilderExtensions.AddToolbox:45 (2)FoundryToolboxBuilderExtensions.AsExisting:152 (1)FoundryToolboxBuilderExtensions.PublishAsExisting:127 (1)FoundryToolboxBuilderExtensions.RunAsExisting:102 (1)FoundryToolboxBuilderExtensions.WithAISearchTool:307 (1)FoundryToolboxBuilderExtensions.WithDescription:196 (1)FoundryToolboxBuilderExtensions.WithMcpTool:218 (1)FoundryToolboxBuilderExtensions.WithWebSearchTool:171 (1)
microsoft/aspire src/Aspire.Hosting.Garnet/api/Aspire.Hosting.Garnet.cs
GarnetBuilderExtensions.WithDataVolume:23 (1)GarnetBuilderExtensions.WithPersistence:26 (1)
microsoft/aspire src/Aspire.Hosting.GitHub.Models/GitHubModelsExtensions.cs
GitHubModelsExtensions.AddGitHubModel:27 (1) (catalog-pinned historical source)GitHubModelsExtensions.WithApiKey:155 (1) (catalog-pinned historical source)
microsoft/aspire src/Aspire.Hosting.Go/api/Aspire.Hosting.Go.cs
GoHostingExtensions.AddGoApp:14 (3)GoHostingExtensions.WithAppArgs:17 (1)GoHostingExtensions.WithDelveServer:21 (1)GoHostingExtensions.WithGoPrivate:34 (1)GoHostingExtensions.WithModDownload:38 (1)GoHostingExtensions.WithModTidy:42 (1)GoHostingExtensions.WithModVendor:46 (1)GoHostingExtensions.WithVetTool:50 (1)
microsoft/aspire src/Aspire.Hosting.Java/JavaHostingExtensions.cs
JavaHostingExtensions.AddJavaApp:80 (2)JavaHostingExtensions.AddJavaContainer:249 (1)JavaHostingExtensions.AddQuarkusApp:402 (2)JavaHostingExtensions.AddSpringBootApp:322 (2)
microsoft/aspire src/Aspire.Hosting.JavaScript/api/Aspire.Hosting.JavaScript.cs
JavaScriptHostingExtensions.AddBunApp:14 (4)JavaScriptHostingExtensions.AddJavaScriptApp:17 (6)JavaScriptHostingExtensions.AddNextJsApp:21 (6)JavaScriptHostingExtensions.AddNodeApp:24 (9)JavaScriptHostingExtensions.AddViteApp:27 (12)JavaScriptHostingExtensions.DisableBuildValidation:31 (2)JavaScriptHostingExtensions.PublishAsNodeServer:35 (5)JavaScriptHostingExtensions.PublishAsPackageScript:40 (4)JavaScriptHostingExtensions.PublishAsStaticWebsite:45 (5)JavaScriptHostingExtensions.WithRunScript:75 (2)JavaScriptHostingExtensions.WithViteConfig:79 (1)
microsoft/aspire src/Aspire.Hosting.JavaScript/JavaScriptHostingExtensions.cs
JavaScriptHostingExtensions.AddDenoApp:817 (2)
microsoft/aspire src/Aspire.Hosting.Kafka/api/Aspire.Hosting.Kafka.cs
KafkaBuilderExtensions.WithHostPort:23 (1)
microsoft/aspire src/Aspire.Hosting.Keycloak/api/Aspire.Hosting.Keycloak.cs
KeycloakResourceBuilderExtensions.AddKeycloak:14 (1)KeycloakResourceBuilderExtensions.WithDataBindMount:17 (1)KeycloakResourceBuilderExtensions.WithDataVolume:20 (1)KeycloakResourceBuilderExtensions.WithOtlpExporter:29 (1)KeycloakResourceBuilderExtensions.WithRealmImport:35 (2)
microsoft/aspire src/Aspire.Hosting.Kubernetes/api/Aspire.Hosting.Kubernetes.cs
CertManagerExtensions.AddIssuer:17 (1)CertManagerExtensions.WithHttp01Solver:26 (1)CertManagerExtensions.WithLetsEncryptProduction:29 (1)CertManagerExtensions.WithLetsEncryptStaging:35 (1)KubernetesEnvironmentExtensions.AddKubernetesEnvironment:59 (3)KubernetesEnvironmentExtensions.AddNodePool:62 (1)KubernetesEnvironmentExtensions.WithHelm:71 (3)KubernetesEnvironmentExtensions.WithNodePool:74 (2)KubernetesGatewayExtensions.AddGateway:84 (2)KubernetesGatewayExtensions.WithHostname:99 (2)KubernetesGatewayExtensions.WithTls:111 (1)KubernetesHelmChartExtensions.AddHelmChart:123 (3)KubernetesIngressExtensions.AddIngress:144 (2)KubernetesIngressExtensions.WithDefaultBackend:147 (1)KubernetesIngressExtensions.WithHostname:150 (1)KubernetesIngressExtensions.WithTls:174 (1)KubernetesPersistentVolumeExtensions.AddPersistentVolume:187 (2)KubernetesPersistentVolumeExtensions.WithAccessMode:190 (2)KubernetesPersistentVolumeExtensions.WithCapacity:193 (1)KubernetesPersistentVolumeExtensions.WithPersistentVolume:199 (2)KubernetesPersistentVolumeExtensions.WithStorageClass:207 (1)KubernetesServiceExtensions.PublishAsKubernetesService:222 (5)
microsoft/aspire src/Aspire.Hosting.Maui/api/Aspire.Hosting.Maui.cs
MauiOtlpExtensions.WithOtlpDevTunnel:65 (1)MauiProjectExtensions.AddMauiProject:72 (2)
microsoft/aspire src/Aspire.Hosting.Milvus/api/Aspire.Hosting.Milvus.cs
MilvusBuilderExtensions.WithAttu:20 (1)MilvusBuilderExtensions.WithConfigurationFile:27 (1)
microsoft/aspire src/Aspire.Hosting.MongoDB/api/Aspire.Hosting.MongoDB.cs
MongoDBBuilderExtensions.AddDatabase:14 (2)MongoDBBuilderExtensions.AddMongoDB:17 (3)MongoDBBuilderExtensions.WithDataBindMount:23 (1)MongoDBBuilderExtensions.WithDataVolume:26 (1)MongoDBBuilderExtensions.WithInitFiles:36 (1)MongoDBBuilderExtensions.WithMongoExpress:39 (1)
microsoft/aspire src/Aspire.Hosting.MongoDB/MongoDBBuilderExtensions.cs
MongoDBBuilderExtensions.WithKeyFile:580 (1)MongoDBBuilderExtensions.WithRepl:196 (1)MongoDBBuilderExtensions.WithReplicaSet:516 (2)MongoDBBuilderExtensions.WithTlsMode:662 (1)
microsoft/aspire src/Aspire.Hosting.MongoDB/ReplicaSet/MongoDBReplicaSetBuilderExtensions.cs
MongoDBReplicaSetBuilderExtensions.AddMongoDBReplicaSet:62 (2)
microsoft/aspire src/Aspire.Hosting.MySql/api/Aspire.Hosting.MySql.cs
MySqlBuilderExtensions.WithCreationScript:20 (1)MySqlBuilderExtensions.WithInitFiles:35 (1)MySqlBuilderExtensions.WithPhpMyAdmin:41 (2)
microsoft/aspire src/Aspire.Hosting.MySql/MySqlBuilderExtensions.cs
MySqlBuilderExtensions.WithRepl:112 (1)
microsoft/aspire src/Aspire.Hosting.Nats/api/Aspire.Hosting.Nats.cs
NatsBuilderExtensions.WithJetStream:26 (2)
microsoft/aspire src/Aspire.Hosting.OpenAI/api/Aspire.Hosting.OpenAI.cs
OpenAIExtensions.AddModel:14 (2)OpenAIExtensions.AddOpenAI:17 (2)OpenAIExtensions.WithApiKey:20 (1)OpenAIExtensions.WithEndpoint:23 (1)
microsoft/aspire src/Aspire.Hosting.Oracle/api/Aspire.Hosting.Oracle.cs
OracleDatabaseBuilderExtensions.AddDatabase:14 (1)OracleDatabaseBuilderExtensions.AddOracle:17 (1)OracleDatabaseBuilderExtensions.WithDataBindMount:20 (1)OracleDatabaseBuilderExtensions.WithDataVolume:23 (1)
microsoft/aspire src/Aspire.Hosting.Orleans/api/Aspire.Hosting.Orleans.cs
OrleansServiceExtensions.AddOrleans:21 (1)OrleansServiceExtensions.WithClustering:39 (1)OrleansServiceExtensions.WithGrainStorage:57 (1)
microsoft/aspire src/Aspire.Hosting.PostgreSQL/api/Aspire.Hosting.PostgreSQL.cs
PostgresBuilderExtensions.AddDatabase:14 (2)PostgresBuilderExtensions.AddPostgres:17 (7)PostgresBuilderExtensions.WithCreationScript:20 (1)PostgresBuilderExtensions.WithDataBindMount:23 (3)PostgresBuilderExtensions.WithDataVolume:26 (6)PostgresBuilderExtensions.WithInitFiles:42 (1)PostgresBuilderExtensions.WithPostgresMcp:56 (2)
microsoft/aspire src/Aspire.Hosting.PostgreSQL/PostgresBuilderExtensions.cs
PostgresBuilderExtensions.WithRepl:146 (1)
microsoft/aspire src/Aspire.Hosting.Python/api/Aspire.Hosting.Python.cs
PythonAppResourceBuilderExtensions.AddPythonApp:15 (6)PythonAppResourceBuilderExtensions.AddPythonExecutable:25 (1)PythonAppResourceBuilderExtensions.AddPythonModule:28 (4)PythonAppResourceBuilderExtensions.AddUvicornApp:31 (5)PythonAppResourceBuilderExtensions.WithPip:42 (3)PythonAppResourceBuilderExtensions.WithUv:46 (3)PythonAppResourceBuilderExtensions.WithVirtualEnvironment:50 (3)
microsoft/aspire src/Aspire.Hosting.RabbitMQ/api/Aspire.Hosting.RabbitMQ.cs
RabbitMQBuilderExtensions.AddRabbitMQ:14 (3)RabbitMQBuilderExtensions.WithManagementPlugin:23 (1)
microsoft/aspire src/Aspire.Hosting.Radius/api/Aspire.Hosting.Radius.cs
RadiusExtensions.WithNamespace:36 (1)
microsoft/aspire src/Aspire.Hosting.Redis/api/Aspire.Hosting.Redis.cs
RedisBuilderExtensions.AddRedis:14 (9)RedisBuilderExtensions.WithDataBindMount:20 (1)RedisBuilderExtensions.WithDataVolume:26 (2)RedisBuilderExtensions.WithPersistence:47 (2)RedisBuilderExtensions.WithRedisCommander:50 (1)RedisBuilderExtensions.WithRedisInsight:53 (2)
microsoft/aspire src/Aspire.Hosting.Redis/RedisBuilderExtensions.cs
RedisBuilderExtensions.WithRepl:232 (2)
microsoft/aspire src/Aspire.Hosting.Rust/RustHostingExtensions.cs
RustHostingExtensions.AddRustApp:72 (1)RustHostingExtensions.WithCargoProfile:467 (1)RustHostingExtensions.WithCargoReleaseBuild:258 (1)
microsoft/aspire src/Aspire.Hosting.SqlServer/api/Aspire.Hosting.SqlServer.cs
SqlServerBuilderExtensions.AddDatabase:14 (3)SqlServerBuilderExtensions.AddSqlServer:17 (2)SqlServerBuilderExtensions.WithCreationScript:20 (1)
microsoft/aspire src/Aspire.Hosting.SqlServer/SqlServerBuilderExtensions.cs
SqlServerBuilderExtensions.WithRepl:130 (1)
microsoft/aspire src/Aspire.Hosting.Valkey/api/Aspire.Hosting.Valkey.cs
ValkeyBuilderExtensions.WithDataVolume:23 (1)ValkeyBuilderExtensions.WithPersistence:26 (1)
microsoft/aspire src/Aspire.Hosting.Valkey/ValkeyBuilderExtensions.cs
ValkeyBuilderExtensions.WithRepl:207 (1)
microsoft/aspire src/Aspire.Hosting.Yarp/api/Aspire.Hosting.Yarp.cs
Yarp.YarpRouteExtensions.WithTransform:154 (1)YarpResourceExtensions.PublishWithStaticFiles:58 (1)YarpResourceExtensions.WithConfiguration:61 (2)
microsoft/aspire src/Aspire.Hosting/api/Aspire.Hosting.cs
ApplicationModel.EndpointReference.GetValueAsync:2613 (1)ApplicationModel.ExecutionConfigurationBuilderExtensions.WithEnvironmentVariablesConfig:2791 (2)ApplicationModel.ExecutionConfigurationBuilderExtensions.WithHttpsCertificateConfig:2795 (1)ApplicationModel.ReferenceExpression.GetValueAsync:3724 (3)ApplicationModel.ResourceExtensions.WithContainerBuildOptions:4141 (2)ApplicationModel.ResourceUrlsCallbackContext.GetEndpoint:4323 (2)ConnectionStringBuilderExtensions.AddConnectionString:74 (2)ContainerRegistryResourceBuilderExtensions.AddContainerRegistry:91 (5)ContainerRegistryResourceBuilderExtensions.WithContainerRegistry:99 (7)ContainerResourceBuilderExtensions.AddContainer:106 (6)ContainerResourceBuilderExtensions.AddDockerfileBuilder:116 (8)ContainerResourceBuilderExtensions.AddDockerfileFactory:123 (1)ContainerResourceBuilderExtensions.AddDockerfile:112 (5)ContainerResourceBuilderExtensions.WithBindMount:133 (5)ContainerResourceBuilderExtensions.WithBuildArg:137 (5)ContainerResourceBuilderExtensions.WithBuildSecret:145 (4)ContainerResourceBuilderExtensions.WithContainerCertificatePaths:149 (2)ContainerResourceBuilderExtensions.WithContainerFiles:153 (3)ContainerResourceBuilderExtensions.WithContainerName:165 (2)ContainerResourceBuilderExtensions.WithContainerNetworkAlias:169 (2)ContainerResourceBuilderExtensions.WithDockerfileBaseImage:190 (2)ContainerResourceBuilderExtensions.WithDockerfileBuilder:195 (7)ContainerResourceBuilderExtensions.WithDockerfileFactory:204 (1)ContainerResourceBuilderExtensions.WithDockerfile:185 (5)ContainerResourceBuilderExtensions.WithImagePullPolicy:224 (2)ContainerResourceBuilderExtensions.WithImageTag:236 (5)ContainerResourceBuilderExtensions.WithLifetime:240 (7)ContainerResourceBuilderExtensions.WithVolume:244 (4)DistributedApplication.CreateBuilder:280 (5)DistributedApplication.RunAsync:298 (6)DistributedApplicationEventingExtensions.OnBeforeResourceStarted:366 (3)DistributedApplicationEventingExtensions.OnConnectionStringAvailable:374 (2)DistributedApplicationEventingExtensions.OnInitializeResource:378 (2)DistributedApplicationEventingExtensions.OnResourceEndpointsAllocated:382 (3)DistributedApplicationEventingExtensions.OnResourceReady:386 (3)DistributedApplicationEventingExtensions.OnResourceStopped:390 (2)DotnetToolResourceExtensions.AddDotnetTool:482 (2)DotnetToolResourceExtensions.WithToolIgnoreExistingFeeds:489 (1)DotnetToolResourceExtensions.WithToolIgnoreFailedSources:493 (1)DotnetToolResourceExtensions.WithToolPrerelease:501 (1)DotnetToolResourceExtensions.WithToolSource:505 (1)DotnetToolResourceExtensions.WithToolVersion:509 (1)ExecutableResourceBuilderExtensions.AddExecutable:522 (4)ExecutableResourceBuilderExtensions.PublishAsDockerFile:528 (3)ExecutableResourceBuilderExtensions.WithWorkingDirectory:544 (1)ExternalServiceBuilderExtensions.AddExternalService:557 (1)IUserSecretsManager.GetOrSetSecret:845 (1)IUserSecretsManager.TrySetSecret:851 (1)McpServerResourceBuilderExtensions.WithMcpServer:902 (4)ParameterResourceBuilderExtensions.AddConnectionString:975 (20)ParameterResourceBuilderExtensions.AddParameterFromConfiguration:990 (2)ParameterResourceBuilderExtensions.AddParameter:978 (8)ParameterResourceBuilderExtensions.PublishAsConnectionString:1002 (1)ParameterResourceBuilderExtensions.WithCustomInput:1006 (2)ParameterResourceBuilderExtensions.WithDescription:1009 (2)Pipelines.DistributedApplicationPipelineExtensions.DisableBuildOnlyContainerValidation:4686 (1)Pipelines.PipelineStep.DependsOn:4854 (2)Pipelines.PipelineStep.RequiredBy:4859 (2)Pipelines.PipelineStepFactoryExtensions.WithPipelineConfiguration:4935 (4)Pipelines.PipelineStepFactoryExtensions.WithPipelineStepFactory:4943 (6)ProjectResourceBuilderExtensions.AddCSharpApp:1030 (9)ProjectResourceBuilderExtensions.AddProject:1037 (18)ProjectResourceBuilderExtensions.WithEndpointsInEnvironment:1065 (1)ProjectResourceBuilderExtensions.WithReplicas:1073 (5)RequiredCommandResourceExtensions.WithRequiredCommand:1090 (1)ResourceBuilderExtensions.ClearContainerFilesSources:1105 (2)ResourceBuilderExtensions.ExcludeFromManifest:1109 (6)ResourceBuilderExtensions.ExcludeFromMcp:1113 (3)ResourceBuilderExtensions.GetConnectionProperty:1117 (1)ResourceBuilderExtensions.PublishWithContainerFiles:1128 (4)ResourceBuilderExtensions.WaitForCompletion:1145 (6)ResourceBuilderExtensions.WaitForStart:1149 (2)ResourceBuilderExtensions.WaitFor:1137 (23)ResourceBuilderExtensions.WithArgs:1157 (8)ResourceBuilderExtensions.WithCertificateTrustScope:1181 (2)ResourceBuilderExtensions.WithCommand:1193 (5)ResourceBuilderExtensions.WithComputeEnvironment:1201 (9)ResourceBuilderExtensions.WithContainerFilesSource:1217 (2)ResourceBuilderExtensions.WithDeveloperCertificateTrust:1231 (2)ResourceBuilderExtensions.WithEndpoint:1235 (10)ResourceBuilderExtensions.WithEnvironment:1258 (36)ResourceBuilderExtensions.WithExplicitStart:1306 (8)ResourceBuilderExtensions.WithExternalHttpEndpoints:1310 (7)ResourceBuilderExtensions.WithHealthCheck:1314 (4)ResourceBuilderExtensions.WithHiddenOnCompletion:1322 (1)ResourceBuilderExtensions.WithHidden:1318 (1)ResourceBuilderExtensions.WithHttpCommand:1330 (3)ResourceBuilderExtensions.WithHttpEndpoint:1338 (7)ResourceBuilderExtensions.WithHttpHealthCheck:1346 (6)ResourceBuilderExtensions.WithHttpProbe:1355 (2)ResourceBuilderExtensions.WithHttpsCertificateConfiguration:1370 (4)ResourceBuilderExtensions.WithHttpsDeveloperCertificate:1375 (5)ResourceBuilderExtensions.WithHttpsEndpoint:1379 (4)ResourceBuilderExtensions.WithIconName:1391 (3)ResourceBuilderExtensions.WithImagePushOptions:1396 (2)ResourceBuilderExtensions.WithLifetimeOf:1411 (2)ResourceBuilderExtensions.WithParentProcessLifetime:1429 (2)ResourceBuilderExtensions.WithParentRelationship:1433 (2)ResourceBuilderExtensions.WithPersistentLifetime:1442 (3)ResourceBuilderExtensions.WithProcessCommand:1447 (3)ResourceBuilderExtensions.WithReferenceEnvironment:1485 (2)ResourceBuilderExtensions.WithReference:1461 (61)ResourceBuilderExtensions.WithRemoteImageName:1510 (2)ResourceBuilderExtensions.WithRemoteImageTag:1515 (2)ResourceBuilderExtensions.WithSessionLifetime:1520 (3)ResourceBuilderExtensions.WithUrlForEndpoint:1536 (3)ResourceBuilderExtensions.WithUrl:1524 (3)ResourceBuilderExtensions.WithUrls:1544 (4)ResourceBuilderExtensions.WithoutHttpsCertificate:1424 (5)TerminalResourceBuilderExtensions.WithTerminal:1579 (7)
Phase B - Doc-tester results
Documentation Test Report
Focus Area: Frozen Phase B — browser-only review of newly added ApiReference replacements in microsoft/aspire.dev PR #1849
Date: 2026-10-09
Tester: doc-tester agent
Local URL: http://localhost:4321/
Head SHA: ef154fd1dd69480e21e4a9dbfaeada659c1fce1d
Merge base: 6f96d2381b5549847395a3fd2c5aa9055273786b
Summary
| Category | Passed | Failed | Warnings |
|---|---|---|---|
| Content Accuracy | 8 | 2 | 0 |
| Code Examples | 0 | 0 | 0 |
| CLI Commands | 0 | 0 | 0 |
| Links | 78 | 2 | 1 |
Counts represent eight deeper page/context checks, two actionable content/link issues, and 78 distinct newly introduced cross-reference destinations checked—not certification of all changed documentation.
Actionable findings: Preserve literal run in editor-mode descriptions and the Aspire 9.2 CLI command list. These substitutions incorrectly render RunAsync for C# readers and link to an application method rather than the command or mode being explained.
Coverage: 148 changed documentation routes exercised: 141 English and seven Japanese. The initial automated sample successfully collected rendering results from 139 routes containing 566 reference components. Eight representative pages were subsequently checked in both AppHost languages. No product workflows, example compilation, source verification, build, or lint were performed.
Critical Issues
Issues that make documentation misleading or incorrect.
Issue 1: The editor’s run mode becomes the RunAsync application API
Location:
/get-started/aspire-vscode-extension/— agent-tool table
src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx:90/get-started/ai-coding-agents/— editor-controlled AppHosts
src/frontend/src/content/docs/get-started/ai-coding-agents.mdx:71/ja/get-started/aspire-vscode-extension/— 実行、デバッグ、デプロイ
src/frontend/src/content/docs/ja/get-started/aspire-vscode-extension.mdx:119
Type: Content/Link
Severity: Critical — incorrect documentation; suggested review priority P2
What the documentation says:
Start a discovered AppHost in RunAsync or debug mode.
Start supports RunAsync and debug modes, and both tools require a trusted workspace and user confirmation.
Japanese rendering:
RunAsync は AppHost を実行します (省略した場合の既定)。
What actually happens:
Selecting C# changes the editor-mode token from literal
runtoRunAsync. Clicking it opensDistributedApplication Methods, at#runasync, instead of documentation about the editor’s run mode.
With TypeScript selected, the visible text remains run, but its destination is likewise the application-method API:
/reference/api/typescript/aspire.hosting/distributedapplication/run/.
Evidence:
- Open
/app-host/eventing/and select its C# AppHost tab. - Navigate to
/get-started/aspire-vscode-extension/. - Observe “Start a discovered AppHost in RunAsync or debug mode.”
- Click the newly introduced reference.
- The browser opens:
http://localhost:4321/reference/api/csharp/aspire.hosting/distributedapplication/methods/#runasync - The rendered page title and heading identify DistributedApplication Methods.
The two other locations reproduced the same C# substitution. Their local diffs previously contained literal `run` in these mode descriptions.
Recommended Action:
- Update documentation to match behavior: retain literal
`run`in all three editor-mode descriptions. - Fix implementation to match documentation
- Add clarifying note
Issue 2: The Aspire 9.2 CLI command list replaces run with RunAsync
Location: /whats-new/aspire-9-2/ — 🆕 Aspire CLI (Preview)
src/frontend/src/content/docs/whats-new/aspire-9-2.mdx:498
Type: Content/Link
Severity: Critical — incorrect documentation; suggested review priority P2
What the documentation says:
RunAsync – Run an Aspire AppHost in development mode
What actually happens:
In the CLI command list, C# preference makes the command name display as
RunAsync, and the reference targets theDistributedApplication.RunAsyncAPI. This is not the CLI command being introduced by the surrounding section.
TypeScript preference conceals the textual mismatch because the application-method label is also run, but the destination remains an API method rather than the CLI command.
Evidence:
- Set the AppHost preference to C#.
- Open
/whats-new/aspire-9-2/. - Read the 🆕 Aspire CLI (Preview) command list.
- Observe the quoted
RunAsyncitem. - The introduced component’s C# destination is:
/reference/api/csharp/aspire.hosting/distributedapplication/methods/#runasync.
The local per-file diff confirms that this item previously displayed literal `run`.
Recommended Action:
- Update documentation to match behavior: restore literal
`run`or link to the appropriate CLI documentation, not the application-method API. - Fix implementation to match documentation
- Add clarifying note
Warnings
Issues that may confuse readers but aren't strictly incorrect.
Warning 1: Runtime coverage is sampled; interrupted visits are not passes
Location: Changed documentation corpus
Issue: Initial parallel visits encountered development-time reload/navigation interruptions. Across completed batches, 139 routes returned usable rendering results and 31 visits were incomplete. Representative checks subsequently covered nine additional unique routes, including the previously interrupted English health-checks page, yielding 148 confirmed routes overall.
Errors included:
page.goto: net::ERR_ABORTED- navigation interrupted by another navigation
Execution context was destroyed, most likely because of a navigation- null navigation response when reading its status
Suggestion: Do not interpret this report as exhaustive runtime coverage of all 294 files or all 40 changed Japanese pages.
Attempted methods: Parallel browser-page navigation, retries with explicit DOM readiness and longer timeouts, then representative testing with development-only WebSocket reload/update messages filtered in the browser. Application scripts remained enabled. Subsequent language switching, navigation, and target checks completed.
The local server also reported unrelated /api/live/ 404s. These were not treated as PR defects.
Passed Checks
- 148 changed documentation routes exercised, with the exact list below.
- Initial successful batch results contained 566 resolved reference components, with no unresolved components or references accidentally rendered inside code/preformatted ancestors.
- Eight representative pages were checked in both C# and TypeScript:
/fundamentals/health-checks//integrations/caching/redis/redis-host//ja/app-host/eventing//ja/app-host/container-files//ja/deployment/pipelines//ja/fundamentals/health-checks//ja/testing/accessing-resources//ja/whats-new/aspire-13-3/
- Their 42 newly added reference occurrences resolved in both language preferences. One unchanged Redis data-volume reference was observed as a control and excluded from the new-reference target count.
- 78 distinct new-reference destinations, spanning 54 API pages, returned HTTP 200; sampled C# fragment targets existed.
- Actual AppHost-language tab switching on the English health-checks page changed:
WaitFor↔waitForWithHttpHealthCheck↔withHttpHealthCheckWithHealthCheck↔withHealthCheck
- Ordinary clicks reached:
- the TypeScript
withHttpHealthCheckreference page; - the C#
WithHttpHealthCheckmethod anchor.
- the TypeScript
- Browser back navigation restored the documentation and retained the selected AppHost language.
- Japanese pages retained Japanese surrounding content while reference labels and destinations switched.
- At 375 × 812, Japanese container-file references rendered readably without clipped labels. A screenshot was inspected before cleanup.
- The sampled health-check, Redis, eventing, container-file, pipeline, testing, and release-note API references matched the API names being discussed; the two reported
runsubstitutions were the observed semantic exceptions.
Recommendations
- Priority fixes: Restore literal
runin the three editor-mode descriptions and the Aspire 9.2 CLI command list. - Documentation gaps: No additional PR-introduced teaching gap established within this cross-reference-only scope.
- Product issues: None established. Development-server reload interruptions and live-service 404s were excluded from PR findings.
Knowledge Gaps
No intrinsic Aspire knowledge was needed to establish these findings: the distinction follows from the rendered editor-mode/CLI context, browser destinations, and the changed documentation’s previous literal tokens.
Product behavior and source/API-contract verification were intentionally left to Phase A. Resolver implementation and API data files were not inspected.
Routes and Sections Exercised
Deeper section checks
| Route | Sections exercised |
|---|---|
/fundamentals/health-checks/ |
Two types of health checks; HTTP health checks for resources; Custom resource health checks |
/integrations/caching/redis/redis-host/ |
Persistence; existing Redis connection; interactive REPL |
/ja/app-host/eventing/ |
リソースイベントの購読 |
/ja/app-host/container-files/ |
Introductory API list; ソース パスをカスタマイズする |
/ja/deployment/pipelines/ |
依存関係管理; リソースレベルステップ; パイプライン設定 |
/ja/fundamentals/health-checks/ |
正常性チェックの 2 つの種類; HTTP/resource health checks |
/ja/testing/accessing-resources/ |
開始と停止 |
/ja/whats-new/aspire-13-3/ |
Changed references in JavaScript/TypeScript, browser logging, AKS, Front Door, Foundry, endpoint/reference changes, and breaking changes |
/app-host/eventing/ |
TypeScript callback aside; resource-event subscription list; actual C# tab interaction |
/get-started/aspire-vscode-extension/ |
Agent-tool run/debug mode table; actual erroneous destination |
/get-started/ai-coding-agents/ |
Editor-controlled AppHost mode paragraph |
/ja/get-started/aspire-vscode-extension/ |
実行、デバッグ、デプロイ |
/whats-new/aspire-9-2/ |
🆕 Aspire CLI (Preview) |
Complete confirmed changed-document route list
/app-host/certificate-configuration/
/app-host/container-files/
/app-host/container-registry/
/app-host/eventing/
/app-host/executable-resources/
/app-host/migrate-from-docker-compose/
/app-host/resource-lifetimes/
/app-host/typescript-apphost/
/app-host/with-terminal/
/app-host/withdockerfile/
/architecture/multi-language-architecture/
/architecture/resource-api-patterns/
/architecture/resource-examples/
/architecture/resource-hierarchies/
/architecture/resource-publishing/
/dashboard/ephemeral-terminals/
/dashboard/explore/
/dashboard/telemetry-after-deployment/
/dashboard/terminals/
/deployment/azure/app-service/
/deployment/azure/azure-developer-cli/
/deployment/azure/azure-security-best-practices/
/deployment/azure/container-apps/
/deployment/azure/sandboxes/
/deployment/custom-deployments/
/deployment/deploy-with-aspire/
/deployment/docker-compose/
/deployment/environments/
/deployment/javascript-apps/
/deployment/kubernetes-gateway-aks/
/deployment/kubernetes-ingress-aks/
/deployment/kubernetes-ingress/
/deployment/kubernetes/aks/
/deployment/kubernetes/clusters/
/deployment/kubernetes/helm-charts/
/deployment/kubernetes/persistent-volumes/
/deployment/pipelines/
/diagnostics/aspireacadomains001/
/diagnostics/aspireacanaming001/
/diagnostics/aspireazure002/
/diagnostics/aspireazure003/
/diagnostics/aspireblazor001/
/diagnostics/aspirebrowserlogs001/
/diagnostics/aspirecertificates001/
/diagnostics/aspirecommand001/
/diagnostics/aspirecompute002/
/diagnostics/aspirecompute003/
/diagnostics/aspirecosmosdb001/
/diagnostics/aspirecsharpapps001/
/diagnostics/aspiredockerfilebuilder001/
/diagnostics/aspiredotnetproject001/
/diagnostics/aspiredotnettool001/
/diagnostics/aspiredurabletask001/
/diagnostics/aspireextension001/
/diagnostics/aspirehostingpython001/
/diagnostics/aspirejavascript001/
/diagnostics/aspiremcp001/
/diagnostics/aspirepersistence001/
/diagnostics/aspirepipelines003/
/diagnostics/aspirepostgres001/
/diagnostics/aspireprobes001/
/diagnostics/aspireprocesscommand001/
/diagnostics/aspireprojects001/
/diagnostics/aspireradius003/
/diagnostics/aspireterminal001/
/diagnostics/aspireusersecrets001/
/diagnostics/overview/
/extensibility/custom-resources/
/extensibility/multi-language-integration-authoring/
/fundamentals/annotations-overview/
/fundamentals/container-networking/
/fundamentals/custom-resource-urls/
/fundamentals/environment-variables/
/fundamentals/external-parameters/
/fundamentals/health-checks/
/fundamentals/persist-data-volumes/
/fundamentals/service-discovery/
/get-started/add-aspire-existing-app/
/get-started/ai-coding-agents/
/get-started/aspire-sdk/
/get-started/aspire-vscode-extension/
/integrations/ai/github-models/github-models-host/
/integrations/ai/ollama/ollama-connect/
/integrations/ai/ollama/ollama-host/
/integrations/ai/openai/openai-host/
/integrations/caching/garnet/garnet-connect/
/integrations/caching/redis-distributed/redis-distributed-host/
/integrations/caching/redis-extensions/
/integrations/caching/redis/redis-connect/
/integrations/caching/redis/redis-host/
/integrations/caching/valkey/valkey-connect/
/integrations/caching/valkey/valkey-host/
/integrations/cloud/azure/aks/
/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-connect/
/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-get-started/
/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host/
/integrations/cloud/azure/azure-ai-search/azure-ai-search-host/
/integrations/cloud/azure/azure-app-service/azure-app-service-get-started/
/integrations/cloud/azure/azure-app-service/azure-app-service-host/
/integrations/cloud/azure/azure-cache-redis/azure-cache-redis-connect/
/integrations/cloud/azure/azure-connector-namespace/
/integrations/cloud/azure/azure-container-registry/azure-container-registry-connect/
/integrations/cloud/azure/azure-container-registry/azure-container-registry-get-started/
/integrations/cloud/azure/azure-container-registry/azure-container-registry-host/
/integrations/cloud/azure/azure-data-explorer/
/integrations/cloud/azure/azure-front-door/
/integrations/cloud/azure/azure-functions/azure-functions-connect/
/integrations/cloud/azure/azure-functions/azure-functions-get-started/
/integrations/cloud/azure/azure-functions/azure-functions-host/
/integrations/cloud/azure/azure-key-vault/azure-key-vault-host/
/integrations/cloud/azure/azure-log-analytics/
/integrations/cloud/azure/azure-openai/azure-openai-host/
/integrations/cloud/azure/azure-postgresql/azure-postgresql-connect/
/integrations/cloud/azure/azure-postgresql/azure-postgresql-host/
/integrations/cloud/azure/azure-service-bus/azure-service-bus-host/
/integrations/cloud/azure/azure-signalr/azure-signalr-connect/
/integrations/cloud/azure/azure-sql-database/azure-sql-database-connect/
/integrations/cloud/azure/azure-sql-database/azure-sql-database-host/
/integrations/cloud/azure/azure-storage-blobs/azure-storage-blobs-connect/
/integrations/cloud/azure/azure-storage-blobs/azure-storage-blobs-host/
/integrations/cloud/azure/azure-storage-queues/azure-storage-queues-connect/
/integrations/cloud/azure/azure-storage-queues/azure-storage-queues-host/
/integrations/cloud/azure/azure-storage-tables/azure-storage-tables-connect/
/integrations/cloud/azure/azure-storage-tables/azure-storage-tables-get-started/
/integrations/cloud/azure/azure-storage-tables/azure-storage-tables-host/
/integrations/cloud/azure/azure-virtual-network/
/integrations/cloud/azure/azure-web-pubsub/azure-web-pubsub-connect/
/integrations/cloud/azure/container-app-jobs/
/integrations/cloud/azure/customize-resources/
/integrations/cloud/azure/local-provisioning/
/integrations/cloud/azure/overview/
/integrations/cloud/azure/user-assigned-identity/
/integrations/compute/docker/
/integrations/compute/floci/
/integrations/compute/k3s/
/integrations/databases/clickhouse/clickhouse-connect/
/integrations/databases/efcore/azure-sql/azure-sql-get-started/
/integrations/databases/efcore/azure-sql/azure-sql-host/
/integrations/databases/efcore/mysql/mysql-connect/
/integrations/databases/efcore/seed-database/
/ja/app-host/container-files/
/ja/app-host/eventing/
/ja/deployment/pipelines/
/ja/fundamentals/health-checks/
/ja/get-started/aspire-vscode-extension/
/ja/testing/accessing-resources/
/ja/whats-new/aspire-13-3/
/whats-new/aspire-9-2/
Cleanup and Frozen Status
- Both browser sessions created for Phase B were closed;
playwright-cli listreported no browsers. - The attached server was stopped using its original shell ID.
- Port 4321 was verified free.
- Specifically named Phase B scripts, logs, JSON inventories, snapshots, and screenshot were deleted.
- HEAD remained unchanged.
- No branch switch, authored repository edit, commit, push, review/comment posting, or production build occurred.
- The four generated
.starlight-iconschanges remain for the parent’s explicitly requested restoration.
Phase B is complete and frozen.
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 92354b96-5c95-491b-93fe-453cb0e1499d
…ence-astro-component
David Pine (IEvangelist)
approved these changes
Oct 13, 2026
David Pine (IEvangelist)
enabled auto-merge (squash)
October 13, 2026 14:39
Alistair Matthews (alistairmatthews)
deleted the
propagate-api-reference-astro-component
branch
October 15, 2026 10:33
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
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
The API Reference Astro component is complete and deployed but only used in Get Started Aspire.dev content. This PR propagates its usage to all other content files where appropriate:
Fixes: #1848
Third-party links and affiliations
None
Validation
pnpm test:unit:api-referencepnpm run devand manually check some instances of theApiReferencecomponent.