Skip to content

docs: update release process for deterministic publish workflow#166

Open
Qbandev wants to merge 1 commit intomainfrom
docs/update-release-process-deterministic-workflow
Open

docs: update release process for deterministic publish workflow#166
Qbandev wants to merge 1 commit intomainfrom
docs/update-release-process-deterministic-workflow

Conversation

@Qbandev
Copy link

@Qbandev Qbandev commented Mar 17, 2026

Summary

Updates docs/release-process.md to reflect the new deterministic release workflow for MetaMask Extension (INFRA-3250, RAPID).

What changed in the workflow:

  • The old tag-release-branch GitHub Action (which only added a tag) is replaced by the new publish-release-from-release-head workflow (manually triggered)
  • Production build, tag, and GitHub release are now created from the release branch HEAD before merging to stable, enforcing Tag SHA == Build SHA == Release target SHA
  • Merging to stable is now a sync step only — it no longer triggers an automatic production build

Diagram nodes updated:

  • CURRENT10: 'Tag Release Branch' GitHub Action'publish-release-from-release-head' workflow
  • CURRENT11: Release tag is added on the release branchProduction build, tag, and GitHub release are created from release branch HEAD
  • STABLE1: A new production build is automatically created and posted on the repo's releases pageRelease branch is merged into 'stable' branch

References

Reflects the new publish-release-from-release-head workflow (INFRA-3250):
production builds are now created from release branch HEAD before merging
to stable, replacing the old automatic build triggered on stable merge.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@Qbandev Qbandev requested a review from a team as a code owner March 17, 2026 10:59
Copy link
Contributor

@chloeYue chloeYue left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@mcmire
Copy link
Contributor

mcmire commented Mar 17, 2026

Curious if at some point we should rename this file client-release-process.md or something? We have other projects that we release (i.e., libraries, GitHub actions, etc.) and this document does not seem to apply to them, only to clients.

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.

3 participants