playwright/docs/development/releasing.md

Releasing is a 3-step process.

1. Create a release branch

1. On your local machine, create a new branch release-X.Y based off the "cutting" commit and land a chore: mark vX.Y.Z in the local branch:

• git checkout main
• git checkout -b release-X.Y
• ./utils/update_version.js vX.Y
• npm run doc
• git commit -am 'chore: mark vX.Y.Z'

1. Push branch to the upstream

• git push upstream release-X.Y

Once release branch is pushed, it's last commit will be picked up by our CI/CD:

• make sure commit passes all the bots. If there are any failures, carefully inspect failures to see if these are flakes.
• the publish_canary workflow will publish a @next version for the commit - this will be our release candidate. Go manually to it's page on NPM to see what it looks like. Try installing locally.

2. Prepare release notes

1. Use "draft new release tag".
2. Version starts with "v", e.g. "vX.Y.Z".
3. Run ./utils/draft_release_notes.sh and fill in the "TODO" in generated text.
4. When making links to the API, copy actual links from GitHub, and not from api.md source - these might be incorrect.
   • Before publishing, replace blob/master/docs with blob/vX.Y.Z/docs in all the links.
5. Use "Save Draft", not "Publish".

3. Publish Release

1. Hit "publish release"

Once release is published, the publish_release will kick in and publish package version on NPM.

4. Bump version on trunk to next

1. Bump a version to the new -next version and land a chore: cut vX.Y.Z-post version commit on trunk

• ./utils/update_version.js vX.Y.Z-next