docs: update release process for Changesets - #3032
Merged
Saadnajmi merged 2 commits intoAug 4, 2026
Merged
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Saadnajmi
marked this pull request as ready for review
July 29, 2026 21:09
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: c19d37f3-daaf-41f8-8166-8400a62733f5
tido64
approved these changes
Aug 4, 2026
Saadnajmi
added a commit
that referenced
this pull request
Aug 6, 2026
## Summary - replace stale Nx Release/version-plan contributor guidance with the current Changesets workflow - document pinned-SHA upstream stable syncs, peer updates, Changeset creation and validation, and lock/pod regeneration - explain that stable-branch pushes create or update a follow-up Changesets version PR that materializes versions and changelogs ## Stale behavior corrected The documented `yarn nx release plan ...` command is now a successful no-op because Nx version plans are disabled. These pages now point contributors to `yarn change`, `yarn change:check`, and the active stable-branch Changesets workflow instead. ## Docusaurus versioning assessment The docsite currently has no `versions.json`, `versioned_docs`, or `versioned_sidebars`. These pages describe the current contributor and release process rather than version-specific user-facing APIs, so snapshotting them would freeze stale operational instructions and multiply maintenance. This PR keeps them as current docs and does not add Docusaurus version snapshots. ## Test plan - `yarn prettier --check docsite/docs/contributing/versioning.md docsite/docs/releases/patch-release.md` - `yarn lint-markdown docsite/docs/contributing/versioning.md docsite/docs/releases/patch-release.md` - `yarn --cwd docsite build` - `yarn --cwd docsite typecheck` *(currently reports the pre-existing missing `@fluentui/react-icons` module in the unchanged homepage components)* --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: c19d37f3-daaf-41f8-8166-8400a62733f5 (cherry picked from commit cc5fac9)
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
2 participants
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.
Summary
Stale behavior corrected
The documented
yarn nx release plan ...command is now a successful no-op because Nx version plans are disabled.These pages now point contributors to
yarn change,yarn change:check, and the active stable-branch Changesetsworkflow instead.
Docusaurus versioning assessment
The docsite currently has no
versions.json,versioned_docs, orversioned_sidebars. These pages describe thecurrent contributor and release process rather than version-specific user-facing APIs, so snapshotting them would
freeze stale operational instructions and multiply maintenance. This PR keeps them as current docs and does not add
Docusaurus version snapshots.
Test plan
yarn prettier --check docsite/docs/contributing/versioning.md docsite/docs/releases/patch-release.mdyarn lint-markdown docsite/docs/contributing/versioning.md docsite/docs/releases/patch-release.mdyarn --cwd docsite buildyarn --cwd docsite typecheck(currently reports the pre-existing missing@fluentui/react-iconsmodule in theunchanged homepage components)