Add six-language AppHost integration documentation - #1635
Add six-language AppHost integration documentation#1635David Pine (IEvangelist) wants to merge 14 commits into
Conversation
dab5efa to
d2a9eeb
Compare
d2a9eeb to
25f487f
Compare
There was a problem hiding this comment.
🟡 Changes recommended
The AKS docs contain malformed fenced code blocks that will not render correctly until the fences are fixed.
Once you've addressed the issues Copilot identified, you can request another Copilot review.
Pull request overview
This PR expands the Aspire integration documentation to show AppHost usage across six languages by adding new <AppHostTabs> fragments and support-aware limitations throughout integration pages, plus a few related MDX repairs and consistency updates.
Changes:
- Adds Python/Go/Java/Rust AppHost examples (or explicit limitations where not validated/exposed) across many integration reference and get-started pages.
- Updates several existing TypeScript snippets for consistent string quoting/formatting and adds multi-language “aspire add …” examples.
- Adjusts some AppHost navigation/query parameters to align with the new language selection mechanism.
File summaries
| File | Description |
|---|---|
| src/frontend/src/content/docs/integrations/overview.mdx | Adds Python/Go/Java/Rust AppHost examples to the integrations overview snippet. |
| src/frontend/src/content/docs/integrations/messaging/lavinmq/lavinmq-host.mdx | Adds limitations metadata to AppHostTabs blocks for unvalidated SDK sequences. |
| src/frontend/src/content/docs/integrations/messaging/lavinmq/lavinmq-connect.mdx | Adds limitations metadata to the AppHostTabs example. |
| src/frontend/src/content/docs/integrations/frameworks/wpf-winforms.mdx | Introduces AppHostTabs with multi-language examples for WPF/WinForms orchestration. |
| src/frontend/src/content/docs/integrations/frameworks/rust/rust-host.mdx | Adds per-language limitations where Rust hosting operations aren’t exported. |
| src/frontend/src/content/docs/integrations/frameworks/rust/rust-get-started.mdx | Adds per-language limitations for Rust get-started AppHost example. |
| src/frontend/src/content/docs/integrations/frameworks/powershell/powershell-host.mdx | Adds per-language limitations for PowerShell hosting operations. |
| src/frontend/src/content/docs/integrations/frameworks/powershell/powershell-get-started.mdx | Adds per-language limitations for the PowerShell get-started AppHost snippet. |
| src/frontend/src/content/docs/integrations/frameworks/perl/perl-host.mdx | Adds per-language limitations for Perl hosting operations. |
| src/frontend/src/content/docs/integrations/frameworks/perl/perl-get-started.mdx | Adds per-language limitations for the Perl get-started AppHost snippet. |
| src/frontend/src/content/docs/integrations/frameworks/nodejs-extensions.mdx | Adds per-language limitations for NodeJS extensions hosting operations. |
| src/frontend/src/content/docs/integrations/frameworks/java/java-host.mdx | Adds per-language limitations for Java hosting operations. |
| src/frontend/src/content/docs/integrations/frameworks/java/java-get-started.mdx | Adds per-language limitations for Java get-started AppHost snippet. |
| src/frontend/src/content/docs/integrations/frameworks/go/go-get-started.mdx | Updates Go integration language support statement and notes experimental status. |
| src/frontend/src/content/docs/integrations/frameworks/dotnet/dotnet-host.mdx | Expands Dotnet hosting reference with AppHostTabs, limitations, and multi-language examples. |
| src/frontend/src/content/docs/integrations/frameworks/deno/deno-host.mdx | Adds per-language limitations for Deno hosting operations. |
| src/frontend/src/content/docs/integrations/frameworks/deno/deno-get-started.mdx | Adds per-language limitations for Deno get-started AppHost snippet. |
| src/frontend/src/content/docs/integrations/frameworks/dapr/dapr-host.mdx | Adds per-language limitations for Dapr hosting operations. |
| src/frontend/src/content/docs/integrations/frameworks/bun-apps.mdx | Adds Python/Go/Java/Rust AppHost examples for Bun resources and endpoints. |
| src/frontend/src/content/docs/integrations/dotnet/maui.mdx | Wraps MAUI AppHost snippets in AppHostTabs with limitations for non-C# SDKs. |
| src/frontend/src/content/docs/integrations/dotnet/launch-profiles.mdx | Adds AppHostTabs examples for launch profile usage and endpoint callback with limitations. |
| src/frontend/src/content/docs/integrations/dotnet/blazor-connect.mdx | Adds Python/Go/Java AppHost examples and a Rust limitation note. |
| src/frontend/src/content/docs/integrations/devtools/sql-projects/sql-projects-host.mdx | Adds per-language limitations and clarifies SDK export constraints for SQL projects/packages. |
| src/frontend/src/content/docs/integrations/devtools/sql-projects/sql-projects-get-started.mdx | Adds per-language limitations for the SQL projects get-started AppHost snippet. |
| src/frontend/src/content/docs/integrations/devtools/mailpit/mailpit-host.mdx | Adds per-language limitations for Mailpit hosting operations. |
| src/frontend/src/content/docs/integrations/devtools/k6/k6-host.mdx | Adds per-language limitations for k6 hosting operations. |
| src/frontend/src/content/docs/integrations/devtools/k6/k6-get-started.mdx | Adds per-language limitations for the k6 get-started AppHost snippet. |
| src/frontend/src/content/docs/integrations/devtools/goff/goff-host.mdx | Adds per-language limitations for GO Feature Flag hosting operations. |
| src/frontend/src/content/docs/integrations/devtools/flagd/flagd-host.mdx | Adds per-language limitations and provides a TS alternative to excluded WithLogLevel. |
| src/frontend/src/content/docs/integrations/devtools/flagd/flagd-connect.mdx | Adds per-language limitations for the OFREP endpoint example. |
| src/frontend/src/content/docs/integrations/devtools/dab/dab-host.mdx | Adds per-language limitations for Data API Builder hosting operations. |
| src/frontend/src/content/docs/integrations/devtools/browser-logs.mdx | Adds multi-language AppHost examples for browser logs and options. |
| src/frontend/src/content/docs/integrations/databases/sqlite/sqlite-host.mdx | Adds per-language limitations; updates TS snippets and some prose line-wrapping. |
| src/frontend/src/content/docs/integrations/databases/sql-server/sql-server-extensions.mdx | Adds per-language limitations to SQL Server extensions examples. |
| src/frontend/src/content/docs/integrations/databases/postgres/postgresql-extensions.mdx | Adds per-language limitations to PostgreSQL extensions examples. |
| src/frontend/src/content/docs/integrations/databases/mysql/mysql-extensions.mdx | Adds per-language limitations to MySQL extensions examples. |
| src/frontend/src/content/docs/integrations/databases/mongodb/mongodb-extensions.mdx | Adds per-language limitations to MongoDB extensions examples. |
| src/frontend/src/content/docs/integrations/databases/meilisearch/meilisearch-host.mdx | Adds per-language limitations; updates TS snippets and some prose line-wrapping. |
| src/frontend/src/content/docs/integrations/databases/kurrentdb/kurrentdb-host.mdx | Adds per-language limitations; updates TS snippets and some prose line-wrapping. |
| src/frontend/src/content/docs/integrations/databases/efcore/seed-database.mdx | Adds AppHostTabs wrapper and limitations for AppHost scenarios in EF Core seed docs. |
| src/frontend/src/content/docs/integrations/databases/efcore/oracle/oracle-host.mdx | Adds AppHostTabs wrapper and limitations for Oracle hosting scenarios. |
| src/frontend/src/content/docs/integrations/custom-integrations/secure-communication.mdx | Adds per-language limitations for a custom integration example. |
| src/frontend/src/content/docs/integrations/custom-integrations/hosting-integrations.mdx | Adds AppHostTabs + limitations and multi-language examples/notes for custom hosting integration docs. |
| src/frontend/src/content/docs/integrations/custom-integrations/client-integrations.mdx | Adds per-language limitations around an advanced custom integration scenario snippet. |
| src/frontend/src/content/docs/integrations/compute/k3s.mdx | Adds per-language limitations for k3s hosting operations. |
| src/frontend/src/content/docs/integrations/cloud/azure/user-assigned-identity.mdx | Adds per-language limitations and normalizes TS snippet quoting/formatting. |
| src/frontend/src/content/docs/integrations/cloud/azure/role-assignments.mdx | Adds per-language limitations and wraps a pipeline-step example in AppHostTabs. |
| src/frontend/src/content/docs/integrations/cloud/azure/local-provisioning.mdx | Adds per-language limitations; reformats tables and examples. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-sql-database/azure-sql-database-host.mdx | Adds per-language limitations and wraps C#-only infra customization in AppHostTabs. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-postgresql/azure-postgresql-host.mdx | Adds per-language limitations and wraps C#-only infra customization in AppHostTabs. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-log-analytics.mdx | Adds per-language limitations and wraps C#-only infra customization in AppHostTabs. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-front-door.mdx | Adds per-language limitations and normalizes TS snippet quoting/formatting. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-default-credential.mdx | Adds per-language limitations for the credential override scenario; reflows note text. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-container-registry/azure-container-registry-get-started.mdx | Adds per-language limitations to the AppHostTabs example. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-container-registry/azure-container-registry-connect.mdx | Adds AppHostTabs multi-language examples for getOutput usage and minor formatting fixes. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-inference/azure-ai-inference-host.mdx | Adds per-language limitations and normalizes TS snippet quoting/formatting. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-inference/azure-ai-inference-get-started.mdx | Adds AppHostTabs limitations and restructures the get-started steps layout. |
| src/frontend/src/content/docs/integrations/cloud/azure/aks/index.mdx | Adds per-language limitations and adjusts example blocks (one code-fence issue noted). |
| src/frontend/src/content/docs/integrations/cloud/azure/ai-compatibility-matrix.mdx | Reformats compatibility table and adds per-language limitations around hosting examples. |
| src/frontend/src/content/docs/integrations/caching/redis-output/redis-output-host.mdx | Adds multi-language AppHost examples for Redis output caching and related CLI snippets. |
| src/frontend/src/content/docs/integrations/caching/redis-extensions.mdx | Adds multi-language CLI + AppHost examples and clarifies generated bindings note. |
| src/frontend/src/content/docs/integrations/caching/redis-distributed/redis-distributed-host.mdx | Adds multi-language CLI + AppHost examples and adjusts note formatting. |
| src/frontend/src/content/docs/integrations/ai/openai/openai-get-started.mdx | Updates text to reflect six-language AppHost examples and normalizes LinkButton formatting. |
| src/frontend/src/content/docs/integrations/ai/github-models/github-models-get-started.mdx | Updates text to reflect six-language AppHost examples and normalizes LinkButton formatting. |
| src/frontend/src/content/docs/app-host/rust-apphost.mdx | Updates “Build your first Aspire app” link to use aspire-lang query parameter. |
| src/frontend/src/content/docs/app-host/python-apphost.mdx | Updates “Build your first Aspire app” link to use aspire-lang query parameter. |
| src/frontend/src/content/docs/app-host/java-apphost.mdx | Updates “Build your first Aspire app” link to use aspire-lang query parameter. |
| src/frontend/src/content/docs/app-host/go-apphost.mdx | Updates “Build your first Aspire app” link to use aspire-lang query parameter. |
Review details
Suppressed comments (1)
src/frontend/src/content/docs/integrations/cloud/azure/aks/index.mdx:97
- The fenced code block for the TypeScript example is malformed (code on the opening fence line and the closing fence appended to a code line). This will prevent correct rendering/copy-paste of the sample.
- Files reviewed: 81/131 changed files
- Comments generated: 1
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
a9b9f54 to
b21305a
Compare
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
b21305a to
6311f11
Compare
Stack 2/5. Depends on #1634.
Adds six-language AppHost coverage across 124 active-English integration pages spanning framework, compute, .NET, devtools, custom, cloud, AI, data, caching, database, messaging, and service categories. All six languages are represented by verified examples or explicit, support-aware limitations.
This stack includes immediate Go
Err()checks, Rust handle serialization, support-aware limitation wording, unified fence audits, and MDX repairs. Python, Go, Java, and Rust remain disabled until stack 5.Focused validation: the integration AppHost language parity Vitest suite passes (3 tests), and
git diff --checkpasses. No local production build was run.