rust@octodon.social ("Rust tips") wrote:
If you're making breaking changes to your library, help your users upgrade by keeping the old names with the #[deprecated] annotation.
#[doc(hidden)]
#[deprecated(note = "Renamed to NewStruct")]
pub type OldStruct = NewStruct;The interface doesn't have to be backwards-compatible. It's there to display a helpful note to users upgrading from the old interface, which is easier than searching changelogs or docs for the new interface.
https://play.rust-lang.org/?gist=2e50923f298a52ffd6cdb25cdc59f753