[docs] Add comprehensive release process documentation from net10.0 branch #30582
Conversation
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
Co-authored-by: rmarinho <1235097+rmarinho@users.noreply.github.com>
Co-authored-by: rmarinho <1235097+rmarinho@users.noreply.github.com>
Copilot
AI
changed the title
Copilot finished work on behalf of
rmarinho
July 11, 2025 16:17
There was a problem hiding this comment.
Pull Request Overview
This PR adds a comprehensive release process guide and updates documentation indexes to reference it:
- Introduces
docs/ReleaseProcess.mdwith end-to-end instructions for building, packing, and publishing .NET MAUI releases, including service releases. - Updates
docs/README.mdandeng/README.mdto link to the new release process documentation.
Reviewed Changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| eng/README.md | Added callout linking to the new Release Process documentation |
| docs/ReleaseProcess.md | New, detailed guide covering Arcade-based build, pack, and release pipelines, branching, channels, and workload integration |
| docs/README.md | Inserted a table entry for the new Release Process guide |
Comments suppressed due to low confidence (2)
docs/ReleaseProcess.md:142
- Consider adding a hyperlink to the https://github.com/dotnet/workload-versions repository for easier navigation.
3. **Automatic Insertion**: The CI system in the `dotnet/workload-versions` repository automatically detects new workload sets and creates pull requests to update Visual Studio release branches.
docs/ReleaseProcess.md:92
- [nitpick] These steps overlap with the earlier 'Release Flow' description. Consider clarifying or merging repeated steps to improve readability.
5. The release pipeline will then:
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.
Note
Are you waiting for the changes in this PR to be merged?
It would be very helpful if you could test the resulting artifacts from this PR and let us know in a comment if this change resolves your issue. Thank you!
This PR moves the comprehensive release process documentation from the
net10.0branch tomainand enhances it with additional information about service releases using the arcade/mirror infrastructure.Changes Made
1. Created
docs/ReleaseProcess.md(243 lines)azure-pipelines-internal.ymlandmaui-release-internal.yml2. Added Service Release Information
darc add-default-channelcommand format:dotnet/workload-versionsrepository and automatic Visual Studio insertions3. Enhanced Documentation Discoverability
docs/README.md: Added ReleaseProcess.md to the documentation index table with proper description for contributors and maintainerseng/README.md: Added cross-reference to the comprehensive release process documentation while maintaining existing dependency management informationKey Features Addressed
✅ Moved release info from net10.0 branch: All content from
docs/ReleaseProcess.mdon the net10.0 branch has been successfully moved to main✅ Default channel creation: Added comprehensive guidance on creating default channels when branching releases, including required darc commands
✅ Workload set integration: Documented the new service release process using arcade/mirror infrastructure with automatic Visual Studio insertions via the
dotnet/workload-versionsrepository✅ Cross-referenced documentation: Updated existing documentation to reference the new comprehensive release process guide
The documentation now provides complete guidance for both regular releases and service releases, ensuring maintainers have all the information needed to manage the .NET MAUI release process effectively.
Fixes #30581.
💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.