Release v4.1

[kennyadsl]

New minor release of Solidus

We are committed to release every quarter in order to have a constant and predictable cadence for our deliverables.

For more information, check out our Release Policy page.

Detailed list of steps for the release

Here are the steps to follow to release a new minor version.

They are written in the order required to make the process work. However, some material required for the release should be prepared before starting with those steps, like the text of the upgrade guide or the messages to send to the community.

Release preparation

• Be sure there are no pending PRs that you want to include in the next minor.
• Run the Prepare Release Workflow, leaving main as the branch and the checkbox to prepare the next major unchecked (unless necessary).
• A new auto-generated PR will appear; be sure everything looks good and merge it.

More details about the release workflows are described on our
Release pipeline automation wiki page,
which we encourage to review if the assignee is not familiar with the topic.

Release the Solidus gems on Rubygems

To officially release the Solidus gems, you need to have permissions on RubyGems, with 2FA enabled.

Open Solidus on your local machine and run:

git checkout main
git pull
gem release

You will be prompted to enter your 2FA code multiple times, one for each solidus' subgems.

• Release on RubyGems done!

After-release Chores

Now that Solidus has been released, we need to cleanup the main branch to get ready for
the next release. As you may have noticed, when the "Release Preparation" PR has been merged,
a new PR has been automatically created. That PR already contains the code to get our repository
clean and ready.

• Post-Release PR Merged!

Steps to do outside the main repository

• [Guides] Publish upgrade instruction for the new version (e.g. PR). solidusio/edgeguides#116
• [Guides] Create a new version with docusaurus of the guides, pointing the main one to the last version released (npm run docusaurus docs:version X.Y). solidusio/edgeguides@3725930
• [Starter Frontend] Create a new matching branch (e.g. v3.3) https://github.com/solidusio/solidus_starter_frontend/tree/v4.1
• [Starter Frontend] In the new branch (e.g. v3.3), change the default solidus target branch in the CircleCI Config to point to the newly created branch. solidusio/solidus_starter_frontend@b9b9dc6
• [Starter Frontend] Change Latest Version Nightly build Scheduled Pipeline's trigger to point to the newly created branch (e.g. v3.3).
• [CircleCI Extensions Orb] Change current and older commands to reflect the new versions status. solidusio/circleci-orbs-extensions#87
• [solidus.io] Add the new version in the versions yml file. solidusio/solidus.io#584
• [solidus.io] Create a new blog post that links to the upgrade instructions on our guides. solidusio/solidus.io#584
• [REST API docs] In the Branches section, track the new version's branch and set it as default.
• [OpenCollective] Create an update for the new release.
• [Twitter] Post a Tweet on our SolidusIO account.
• [GitHub Discussions] Create a new Discussion for the new Minor release in the Announcements category (eg. #4161), and add a link to the upgrade instructions on our guides. #5195
• [Slack] Notify the community in the #general channel.
• [Wiki] Add the new version.
• [RubyFlow] Post an update to get visibility on RubyWeekly.

[waiting-for-dev]

Great work! ❤️