Repository navigation
[docs] Document initial WSLc publish support - #2081
Closed
aspire-repo-bot[bot] wants to merge 2 commits into
Closed
aspire-repo-bot[bot] wants to merge 2 commits into
aspire-repo-bot[bot] wants to merge 2 commits into
Conversation
Merged
5 of 14 tasks
David Pine (IEvangelist)
requested review from
David Negstad (danegsta)
and removed request for
Sébastien Ros (sebastienros)
November 12, 2026 23:54
David Pine (IEvangelist)
marked this pull request as ready for review
November 13, 2026 14:54
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
An unescaped apostrophe prevents the prerequisites page from compiling, and unchanged Playwright expectations will fail against the revised wording.
2 open issues
What changed in this PR
Updates Aspire’s prerequisite and configuration documentation to describe initial, limited WSLc publishing support introduced by microsoft/aspire#21009.
Changes:
- Replaces local-development-only wording with supported publishing operations and remaining limitations.
- Adds
TargetPlatform = nullguidance for Dockerfile builds with WSLc.
| File | Description |
|---|---|
src/frontend/src/content/docs/get-started/prerequisites.mdx |
Updates the WSLc status, description, and publishing guidance. |
src/frontend/src/content/docs/app-host/configuration.mdx |
Expands ASPIRE_CONTAINER_RUNTIME documentation with WSLc publishing capabilities and restrictions. |
Review effort: Balanced
| href: 'https://aka.ms/aspire/containers', | ||
| linkLabel: 'Set up WSLc', | ||
| statusLabel: 'Windows local development only', | ||
| statusLabel: 'Windows only; limited publish support', |
Contributor
There was a problem hiding this comment.
Updated both WSLc expectations in 442928e to match the new status and limited-publishing wording, including the Compose deployment limitation. E2E execution is left to CI; local lint was unavailable because pnpm is not installed.
| statusLabel: 'Windows only; limited publish support', | ||
| description: | ||
| 'A supported container runtime for local development on Windows. Requires WSLc version 3.0.2.0 or later. Publishing and deployment are not supported yet.', | ||
| 'A supported container runtime for local development on Windows. Requires WSLc version 3.0.2.0 or later. Publishing has initial, limited support; Compose deployment isn't supported.', |
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
David Pine (IEvangelist)
added a commit
that referenced
this pull request
Nov 17, 2026
## Summary Consolidates the open `docs-from-code` PRs that cover features from @IEvangelist's product work or that request their review, all targeting `release/17.0`, into this single PR. Each PR was checked against its merged microsoft/aspire source PR and against product `release/17.0`, to confirm the change shipped in 17.0 and is user-facing rather than an implementation detail. Accepted text was corrected where the bot's wording was inaccurate. | PR(s) | Verdict | Notes | | --- | --- | --- | | #2103, #2098, #1967, #2073, #2070 | Accepted with fixes | Go AppHost conventions, `aspire init`, and VS Code extension. Unrelated e2e test edits from #2073 were dropped. | | #1972 | Partially accepted | Only the verified behavior was kept. | | #2069, #2064, #1829 | Accepted with fixes | Dashboard explore page and `aspire describe --format Mermaid` | | #2044 | Partially accepted | The Cards/Home/Graph layout selector text is outdated, so it was dropped. | | #1959, #1904, #1835, #1801 | Accepted with fixes | `WithTerminal` options, the dashboard terminal UX, and TypeScript `configure` | | #1902 | Accepted with fixes | `dotnet run --operation publish` guidance | | #2081 | Accepted with fixes | WSLc limited publish support. The minimum version is corrected to 3.0.4.0. | | #2014, #1862, #1809, #1936, #2140, #1997, #2051, #2068, #2022, #1963 | Accepted with fixes | DCP timeouts, the container tunnel base image, browser origins, the PVC `WithConfiguration` API, the interaction service caution, secrets, `aspire update`, and agent init telemetry | | #2092 | Rejected | Documents implementation details. | | #2078 | Rejected | Already documented correctly; the proposed text was wrong. | | #2110, #2104, #2085, #2094 | Rejected | The product change isn't in `release/17.0`; it's 17.1-only. Redo these against the next release branch. | | #2133 | Rejected for now | Its backport, microsoft/aspire#22219, is still open, so redo this once it merges. | Additional consistency fixes: - **WSLc:** the minimum version is now 3.0.4.0, the source's `MinimumWslcVersion`, across prerequisites, `aspire doctor`, configuration, and what's new. The pages now describe limited publish support and state that Docker Compose isn't supported. - **`WithTerminal`:** `WithTerminal` and `TerminalOptions` are no longer `[Experimental]` in 17.0. I removed the stale `ASPIRETERMINAL001` pragmas and cautions and rewrote the diagnostic page to cover the terminal APIs that are still experimental. Closes #2140 Closes #2133 Closes #2110 Closes #2104 Closes #2103 Closes #2098 Closes #2094 Closes #2092 Closes #2085 Closes #2081 Closes #2078 Closes #2073 Closes #2070 Closes #2069 Closes #2068 Closes #2064 Closes #2051 Closes #2044 Closes #2022 Closes #2014 Closes #1997 Closes #1972 Closes #1967 Closes #1963 Closes #1959 Closes #1936 Closes #1904 Closes #1902 Closes #1862 Closes #1835 Closes #1829 Closes #1809 Closes #1801 ## Third-party links and affiliations None. The only added external link is to mermaid.js.org, which the page already links elsewhere. ## Validation - I compared each claim with the merged microsoft/aspire source and checked that it's included in product `release/17.0`, using `gh api compare` and searches for backport PRs. - I checked the TypeScript sample against the generated `aspire.d.ts`. `EndpointReferenceExpression` is an `IValueProvider`. - I reviewed the full diff by hand for MDX and table formatting, imports, and anchors. The new `seoTitle` is 58 characters. - I didn't run any local unit, e2e, or build commands because frontend dependencies aren't installed locally. CI covers the build, unit, and e2e checks, including the updated `custom-components.spec.ts` assertion. --------- Co-authored-by: David Pine <7679720+IEvangelist@users.noreply.github.com> Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Collaborator
|
Superseded by #2189 (merged to release/17.0) |
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.

Documents changes from microsoft/aspire#21009
Author:
@danegstaTargeting
release/17.0— the latest release branch onmicrosoft/aspire.dev— becauserelease/17.1(from the source PR milestone17.1) does not exist there.Why
The docs said WSLc doesn't support publish/deploy. The source PR adds initial, limited WSLc publishing (signals:
pr_body_has_user_facing_section,pr_body_has_cli_flag_mention).Changes (updated existing pages)
src/frontend/src/content/docs/app-host/configuration.mdx:ASPIRE_CONTAINER_RUNTIMErow describes supported and unsupported publish operations.src/frontend/src/content/docs/get-started/prerequisites.mdx: WSLc status label, description, and note updated, including theTargetPlatform = nullguidance.