3 ms·
> instead of choosing a certain numbered version of the random library (if I remember correctly) I let cargo download the latest version which had a completely
by estebank 3y ago
> instead of choosing a certain numbered version of the random library (if I remember correctly) I let cargo download the latest version which had a completely different API.
Yeah, they didn't follow the instructions and got burned. I still think that multiple things went wrong simultaneously for that experience. I wonder if more prevalent uses of `#[doc(alias = "name")]` being leveraged by https://github.com/rust-lang/rust/pull/120730 https://github.com/rust-lang/rust/pull/120730 (which now that I check only accounts for methods and not functions, I should get on that!) so that when changing APIs around people at least get a slightly better experience.
- steveklabnik 3y agoAhhh nice catch. Yeah, I think that might help, but also, on some level, if people choose to not follow instructions, additional instructions don’t tend to help. Doesn’t mean it’s not worth trying in some circumstances, of course…