Select a version number
WxT releases are numbered using a form of semantic versioning. More information can be found in our Versioning page.
In general, when preparing a release: increment the FEATURE when Drupal Core has a major release (ie. 9.5.x to 10.0.x) otherwise simply increment the SPRINT number.
Create an issue on GitHub.com
Create an issue in the Drupal WxT project on GitHub for release tracking, title it
Release x.x.x (where x.x.x is the incremented version number).
This issue should contain the following checklist as well as any other related steps or information regarding preparing the release.
See the [full release documentation](https://drupalwxt.github.io/docs/development/release-process/) for more detail. - [ ] All related projects (wxt_library and wxt_bootstrap) tagged and released on GitHub.com and Drupal.org - [ ] Version number selected - [ ] CHANGELOG.md updated - [ ] composer.json updated - [ ] Run version.sh for hook_updates and wxt contrib - [ ] CI build passes - [ ] Releases tagged and pushed to GitHub.com and Drupal.org - [ ] WxT released on Drupal.org (https://drupalwxt.github.io/docs/development/release-process/#release) - [ ] Add changelog information to published tag once CI is done
Ensure the changelog contains an entry for the release and is updated as issues and changes are resolved (in the next steps or when committing code / changes).
Review dependent wxt modules
- Review contrib modules in composer.json (or in a site install; extend->update) and update as necessary.
- If necessary, tag wxt_library and update wxt’s
- If necessary, tag wxt_bootstrap and update wxt’s
All projects must be released on drupal.org (and github).
Note: Changes to
composer.jsonfile (specifically dev dependencies and repositories) should be mentioned in the CHANGELOG.
Drupal.org does not currently support semantic versioning. Instead, the version number on drupal.org is
X = MAJOR
Y = FEATURE
ZZ = SPRINT(two digits - add leading zero for < 10)
If the wxt dependent modules are updated, we need to reflect this in wxt
composer.json and the CHANGELOG.
git clone https://github.com/drupalwxt/wxt.git
- Confirm or update that it’s using appropriate tags of wxt_library + wxt_bootstrap (
- Push to github.com and drupal.org repositories any changes
- Ensure GitHub Actions build passes
GitHub.com and Drupal.org
git tag MAJOR.FEATURE.SPRINT
git push $GITHUB_REMOTE MAJOR.FEATURE.SPRINT
- Go to Tags page
- Click … and select create release on the tag
- Enter the version number in the release title
- Copy the changelog entry for this release into the
- Click publish release
The builds on Drupal.org are incomplete as they don’t fully support Composer yet which is why we host a tarball on GitHub for those not using Composer.
- Drupal WxT Release Page
- Select the tag
- Copy/paste the following blurb into the release notes:
<strong>CHANGELOG</strong> See the <a href="https://github.com/drupalwxt/wxt/blob/5.0.x/CHANGELOG.md">changelog.md</a> file.