Skip to content

Add six-language AppHost integration documentation - #1635

Open
David Pine (IEvangelist) wants to merge 14 commits into
ievangelist-create-foundation-prfrom
ievangelist-add-integration-docs
Open

Add six-language AppHost integration documentation#1635
David Pine (IEvangelist) wants to merge 14 commits into
ievangelist-create-foundation-prfrom
ievangelist-add-integration-docs

Conversation

@IEvangelist

Copy link
Copy Markdown
Member

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 --check passes. No local production build was run.

@aspire-repo-bot aspire-repo-bot Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated wording suggestions from the forbidden-words check. Apply the suggestions to resolve them.

Comment thread src/frontend/src/content/docs/integrations/databases/efcore/seed-database.mdx Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 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.

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Frontend HTML artifact ready

The latest frontend build uploaded the frontend-dist artifact for PR #1635. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #1635 artifacts

This comment updates automatically when a new frontend build artifact is uploaded.

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>
@IEvangelist
David Pine (IEvangelist) force-pushed the ievangelist-add-integration-docs branch from b21305a to 6311f11 Compare September 10, 2026 13:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants