dist rename rollout plan

[mistydemeo]

In #1267, we're working towards renaming cargo-dist to dist. We have a few steps to do in this release and in the releases to follow.

Now

• Replace all user-facing references to cargo-dist with dist, except in the names of the installers and related packages
• Thoroughly test the new dist binary and its cargo-dist alias, ensuring it works both ways
• Update the documentation with the new name
• Write a blog post announcing the new name

When 0.24.0 is released

• Publish doc changes
• Publish blog post

After 0.24.0 is released

• Prepare to rename the package so that future installers use the name dist instead of cargo-dist
• Ensure the Homebrew package can retain its name for compatibility OR use a Homebrew tap rename to handle the Homebrew name change
• Decide how to handle crates.io package name changes
• Cut a minor release with these changes

Sometime after that minor release

• Cut a release under the new package name, so the intermediate release has a package to upgrade to

[mistydemeo]

The rename infrastructure is available in #1647. The actual rename is in #1648.

I've tested out the rename in a fork of cargo-dist using the content of those two PRs. I staged the rename over several versions.

• 0.91.0: Standard release named cargo-dist, nothing changed: https://github.com/mistydemeo/cargo-dist/releases/tag/v0.91.0
• 0.92.0: First release with rename infrastructure present, still named cargo-dist: https://github.com/mistydemeo/cargo-dist/releases/tag/v0.92.0
• 0.100.0: First release named dist: https://github.com/mistydemeo/cargo-dist/releases/tag/v0.100.0
• 0.101.0: Another release named dist, no other changes: https://github.com/mistydemeo/cargo-dist/releases/tag/v0.101.0

In tests, 0.91.0 can upgrade to 0.92.0 as expected. 0.92.0 can then upgrade to either 0.100.0 or 0.101.0 safely. The new version installs a new receipt under the new name.

So, in other words, I think we can safely do this in two releases:

• A pre-1.0 release which adds the rename support mechanism from feat: add rename infrastructure #1647, which existing users can upgrade to.
• A 1.0 release which performs the rename from feat: rename cargo-dist => dist #1648.

Here's a sample of the formula rename: mistydemeo/homebrew-cargodisttest@64ac747

We just need to delete the Formula/cargo-dist.rb version and add the formula_renames.json file. Then, Homebrew will just go ahead and use the new formula file generated by dist and will be able to apply upgrades.