To publish a new version of these crates:
-
Bump the crate versions using semantic versioning. As described in Cargo's semver compatibility documentation and because this crate is not yet released as "1.0", we typically release major breaking changes as a minor semver bump and anything less than that as a patch semver bump. After bumping, open a PR:
git checkout -b bump-version cargo xtask bump patch --git git push -u <FORK> # open PR
-
Once the bump PR is merged, publish the crates:
git checkout main git pull cargo xtask publish --git
You may want to check that everything looks right on crates.io after this step. Note that the
--git
flag is equivalent togit tag v<VERSION>; git push origin v<VERSION>
. If your remotes won't work with this defaultorigin
for any reason, those commands can be run manually.
- Once published, draft a new release on GitHub. Use the newly-published tag and use "Generate release notes" for a sane changelog description.
- Eventually, check that docs.rs was able to build the crate documentation correctly.