Add streamlined CoreCLR WebAssembly documentation with essential build and debug workflows#119104
Merged
AaronRobinsonMSFT merged 11 commits intomainfrom Aug 28, 2025
Merged
Conversation
Co-authored-by: lewing <24063+lewing@users.noreply.github.com>
…ments Co-authored-by: lewing <24063+lewing@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Add wasm CoreCLR workflow documentation (build, test, debug, state, and next steps)
Add CoreCLR WebAssembly documentation with build, test, and debug workflows
Aug 26, 2025
lewing
reviewed
Aug 26, 2025
Member
AaronRobinsonMSFT
left a comment
AaronRobinsonMSFT
left a comment
There was a problem hiding this comment.
@copilot Please apply review feedback.
…ection, and fix extension links Co-authored-by: AaronRobinsonMSFT <30635565+AaronRobinsonMSFT@users.noreply.github.com>
Contributor
Author
Copilot
AI
changed the title
Add CoreCLR WebAssembly documentation with build, test, and debug workflows
Add streamlined CoreCLR WebAssembly documentation with essential build and debug workflows
Aug 26, 2025
Co-authored-by: AaronRobinsonMSFT <30635565+AaronRobinsonMSFT@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Member
|
/cc @pavelsavara |
pavelsavara
reviewed
Aug 27, 2025
pavelsavara
reviewed
Aug 27, 2025
Contributor
There was a problem hiding this comment.
Pull Request Overview
This PR introduces comprehensive documentation for building, running, and debugging CoreCLR on WebAssembly, addressing the experimental WASM support workflow needs. The documentation provides developers with essential instructions from initial setup through advanced debugging scenarios.
Key Changes:
- Added complete WebAssembly build and debug workflow documentation
- Enhanced discoverability by linking the new guide from the main CoreCLR README
- Included both browser and console testing approaches with debugging support
Reviewed Changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
docs/workflow/building/coreclr/wasm.md |
New comprehensive guide covering WebAssembly build commands, testing approaches, and debugging workflows for CoreCLR |
docs/workflow/building/coreclr/README.md |
Added "Platform-Specific Guides" section with link to the new WebAssembly documentation |
pavelsavara
approved these changes
Aug 28, 2025
Member
|
/ba-g Helix isn't needed for markdown changes. |
AaronRobinsonMSFT
deleted the
copilot/fix-a6cf036d-78cb-4dd0-ab7e-ded31276babc
branch
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 subscribe to this conversation on GitHub.
Already have an account?
Sign in.
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.
This PR adds focused documentation for building, running, and debugging CoreCLR on WebAssembly, addressing the workflow needs outlined in issue #119002.
Changes
New Documentation:
docs/workflow/building/coreclr/wasm.mdAdded a streamlined guide covering:
./build.sh/build.cmdwith-os browsertarget andclr.runtimesubsetdotnet-serve(recommended)Updated Main README:
docs/workflow/building/coreclr/README.mdAdded a new "Platform-Specific Guides" section linking to the WebAssembly documentation, making it discoverable alongside existing platform guides.
Implementation Details
The documentation focuses on the core workflow needed to get started with CoreCLR WebAssembly development:
clr.runtimesubsetdotnet-servefor browser scenariosThis provides developers with the essential information needed to start working with the experimental CoreCLR WebAssembly support, from initial setup through debugging scenarios.
Fixes #119002
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.