Skip to content

Improve discovery of WSL containers preview - #2617

Open
John Kennedy (GrantMeStrength) wants to merge 1 commit into
mainfrom
jken-main/promote-wsl-containers
Open

John Kennedy (GrantMeStrength) wants to merge 1 commit into
mainfrom
jken-main/promote-wsl-containers

Conversation

@GrantMeStrength

Copy link
Copy Markdown
Contributor

Summary

  • Add a prominent WSL containers (preview) section after Get started on the landing page, retaining Install WSL as the primary action.
  • Group the existing overview and CLI tutorial under WSL containers (preview) in the TOC, with direct links to the Windows app API guide, reference, and samples. Remove the former scattered entries.
  • Explain the distinction between WSL containers, WSL distributions, third-party container tools, and Dev Containers without claiming interchangeable workflows.
  • Distinguish WSL prereleases from Windows Insider builds and link to the maintained container prerequisites rather than duplicating version requirements.

Affected pages

Scope and review

Existing page URLs, API examples, and installation procedures remain unchanged. Containers are explicitly labeled as preview; this change makes no adoption or GA claims. Please review the new TOC grouping and preview wording.

The comparison and preview guidance follow the current feature documentation and announcement:
https://devblogs.microsoft.com/commandline/wsl-container-is-now-available-for-public-preview/

Validation

  • TOC YAML parses, and the existing overview and CLI tutorial each retain one unanchored TOC entry.
  • Local file links and the newly used API/install anchors resolve.
  • git diff --check passes.

Promote CLI and app API workflows, group existing navigation, and distinguish WSL prereleases from Windows Insider builds.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: efdb44cf-be0d-4246-a369-e9b0d5d4b16c
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 038169f:

✅ Validation status: passed

File Status Preview URL Details
WSL/index.md ✅Succeeded View
WSL/toc.yml ✅Succeeded View
WSL/wsl-container.md ✅Succeeded View

For more details, please refer to the build report.

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.

🟢 Approval recommended

The documentation, navigation, anchors, and preview wording are consistent and introduce no unresolved issues.

Pull request overview

Improves discovery and positioning of the WSL containers public preview while preserving existing installation guidance.

Changes:

  • Adds prominent landing-page preview guidance and workflow links.
  • Consolidates container documentation in the TOC.
  • Clarifies distinctions between WSL containers and related tooling.
File summaries
File Description
WSL/index.md Adds preview discovery and prerequisite guidance.
WSL/toc.yml Groups container resources under one section.
WSL/wsl-container.md Adds preview status and workflow comparisons.
Review details
  • Files reviewed: 3/3 changed files
  • Comments generated: 0
  • Review effort level: Balanced

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

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