Release: 10.9.1

[github-actions]

This is the patch release pull request for WooCommerce Blocks plugin 10.9.1.

Changelog

---

> Changelog Error: Changelog could not be generated because there is no milestone for the release branch that was pushed. Double-check the spelling on the release branch and ensure that you have a milestone corresponding to the version in the branch name. If you found the error, you can restart by deleting the branch and this pull and pushing a new branch.
> You'll need to edit this section manually

---

Communication

Prepared Updates

Please leave a comment on this PR with links to the following:

• Release announcement (announcement post on developer.woocommerce.com published after release).

Developer Notes - The following issues require developer notes in the release post:

Devnotes Error: Changelog could not be generated because there is no milestone for the release branch that was pushed. Double-check the spelling on the release branch and ensure that you have a milestone corresponding to the version in the branch name. If you found the error, you can restart by deleting the branch and this pull and pushing a new branch.
PRs tagged for dev notes cannot be found, you'll need to edit this section manually.

• Happiness engineering or Happiness/Support (if special instructions needed).
• Relevant developer documentation (if applicable).

Quality

This section is for things related to quality around the release.

• Testing Instructions are included in this PR

• Any performance impacts are documented.

---

🚀 This pull request was generated by the automations bot triggered by the creation of the branch: release/10.9.1. cc @tarunvijwani

[github-actions]

The release pull request has been created! This checklist is a guide to follow for the remainder of the patch release process. You can check off each item in this list once completed.

• Checkout the release branch locally.

Initial Preparation

• Close the milestone of the release you are going to ship. That will prevent newly approved PRs to be automatically assigned to that milestone.
• Check that the release automation correctly added the changelog to readme.txt
• Ensure you pull your changes from the remote, since GitHub Actions will have added new commits to the branch.
  • Check the version and date in the changelog section within readme.txt, e.g. = 10.9.1 - YYYY-MM-DD =
  • Check the changelog matches the one in the pull request description above.
• Update compatibility sections (if applicable). Note: Do not change the stable tag or plugin version; this is automated.
• Push above changes to the release branch.

Create the Testing Notes

• Run npm ci
• Run npm run package-plugin:deploy. This will create a zip of the current branch build locally.
• Create the testing notes for the release.
  • For each pull request linked in the changelog grab the User Facing Testing notes from the PR's description.
  • Add the notes to docs/testing/releases
  • Update the docs/testing/releases/README.md file index.
• Copy a link to the release zip you created earlier into the testing notes. To generate the link you can upload the zip as an attachment in a GitHub comment and then just copy the path (without publishing the comment).
• Commit and push the testing docs to the release branch.
• Smoke test built release zip using the testing instructions you created:
  • Test in a clean environment, e.g. Jurassic.Ninja site.
  • Test existing WooCommerce Blocks content works correctly after update (no block validation errors).
  • Test to confirm blocks are available and work correctly in oldest supported WordPress version (e.g. 5.3).
  • Confidence check - check blocks are available and function.
  • Test to confirm new features/fixes are working correctly.
  • Test any UI changes in mobile and desktop views.
  • Smoke test – test a cross section of core functionality.
• Ask the porters of Rubik and Kirigami to smoke test the built release zip as well and to approve the PR if everything looks good.

Each porter is responsible for testing the PRs that fall under the focus of their own team. Shared functionality should be tested by both porters. This means that the Rubik porter will mostly test checkout blocks and Store API endpoints, while the Kirigami porter will test the product related blocks and Store API endpoints.

• If all PRs are testing as expected, continue with the release.
• If one or more PRs are not testing as expected: ping the PR authors and the porter of the relevant team and ask them if the change is a release blocker or not (you can also ping the team lead if any of them is not available). In general, if it's not a regression or there is no product/marketing reason why that PR is a blocker, all other PRs should default to not being blockers.
  • If there are blockers: stop the release and ask the PR author to fix them. If the PR author is AFK, ping the porter of their team.
  • If some PRs are not testing as expected but they are not blockers: revert the relevant commits, remove the changes from testing steps and changelog, open an issue (or reopen the original one) and proceed with the release.
  • If minor issues are discovered during the testing, each team is responsible for logging them in Github.

Update Pull Request description and get approvals

• Go through the description of the release pull request and edit it to update all the sections and checklist instructions there.
• Execute npm run deploy
  • Note: the script automatically updates version numbers (commits on your behalf).
  • ALERT: This script will ask you if this release will be deployed to WordPress.org. You should only answer yes for this release if it's the latest release and you want to deploy to WordPress.org. Otherwise, answer no. If you answer yes, you will get asked additional verification by the npm run deploy script about deploying a patch release to WordPress.org.

If this release is deployed to WordPress.org...

• An email confirmation is required before the new version will be released, so check your email in order to confirm the release.
• Edit the GitHub release and copy changelog into the release notes.
• The #woo-blocks-repo slack instance will be notified about the progress with the WordPress.org deploy. Watch for that. If anything goes wrong, an error will be reported and you can followup via the GitHub actions tab and the log for that workflow.
• After the wp.org workflow completes, confirm the following
  • Changelog, Version, and Last Updated on WP.org plugin page is correct.
  • Confirm svn tag is correct, e.g. 10.9.1
  • Confirm WooCommerce.com plugin page is updated.
  • Download zip and smoke test.
  • Test updating plugin from previous version.

After Deploy

• Merge this branch back into the base branch.
  • If the base branch was trunk, and this release was deployed to WordPress.org, then merge the branch into trunk.
  • If the base branch is the release branch this patch release is for, then merge branch into release branch and then merge the release branch back to trunk if the patch release is the latest released version. Otherwise just merge back into the release branch.
• If you merged the branch to trunk, then update version on the trunk branch to be for the next version of the plugin and include the dev suffix (e.g. something like 2.6-dev) for the next version.
• Update the schedules p2 with the shipped date for the release (PdToLP-K-p2).
• Edit the GitHub milestone of the release you just shipped and add the current date as the due date (this is used to track ship date as well).

Pull request in WooCommerce Core for Package update

This only needs done if the patch release needs to be included in WooCommerce Core.

• Create a pull request for updating the package in WooCommerce core (based off of the WooCommerce core release branch this is deployed for).
  • Create the pull request in the WooCommerce Core Repository that bumps the package version for the blocks package to the version being pulled in.
  • The content for the pull release can follow this example. Essentially you link to all the important things that have already been prepared. Note, you need to make sure you link to all the related documents for the feature plugin releases since the last package version bump in Woo Core.
    • The PR's changelog should be aggregated from all the releases included in the package bump. This changelog will be used in the release notes for the WooCommerce release. That's why it should only list the PRs that have WooCoomerce Core in the WooCommerce Visibility section of their description. Don't include changes available in the feature plugin or development builds.
  • Run through the testing checklist to ensure everything works in that branch for that package bump. Note: Testing should include ensuring any features/new blocks that are supposed to be behind feature gating for the core merge of this package update are working as expected.
  • Testing should include completing the Smoke testing checklist. It's up to you to verify that those tests have been done.
  • Verify and make any additional edits to the pull request description for things like: Changelog to be included with WooCommerce core, additional communication that might be needed elsewhere, additional marketing communication notes that may be needed etc.
  • After the checklist is complete and the testing is done, it will be up to the WooCommerce core team to approve and merge the pull request.
• Make sure you join the #woo-core-releases Slack channel to represent Woo Blocks for the release of WooCommerce core this version is included in.

Publish Posts

You only need to post public release announcements and update relevant public facing docs if this patch release is deployed to WP.org. Otherwise, you can skip this section.

• Post release announcement on WooCommerce Developer Blog.
  • Ping porters from each team to know which changelog entries need to be highlighted. Ask them to write a short text and optionally provide a screenshot. They can use previous posts for inspiration, we usually try to highlight new features or API changes.
  • Ensure the release notes are included in the post verbatim.
  • Don't forget to use category WooCommerce Blocks Release Notes for the post.
• Announce the release internally (#woo-announcements slack).
• Update user-facing documentation as needed. When the plugin is released, ensure user-facing documentation is kept up to date with new blocks and compatibility information.
  • Update minimum supported versions (WordPress, WooCommerce Core) and other requirements where necessary, including:
    • WCCOM product page
    • WooCommerce blocks main documentation page

🚀 This comment was generated by the automations bot triggered by the creation of the branch: release/10.9.1. cc @tarunvijwani