Remove crate version from docs.rs

[sunjay]

Is there a way to remove certain versions of a crate from docs.rs?

[onur]

Currently there isn't a way to remove crates from docs.rs. I am planning to add a method to check yanked crates and show a warning or remove the crate completely from docs.rs.

For now, I can manually remove the crate if there is an urgency.

[sunjay]

Could you remove the yanked versions of the turtle crate? That's currently all the versions.

Thanks

[pravic]

• futures 0.2.x have been yanked as well, see docs.rs/futures redirects to yanked version #221

[jyn514]

We've since redirected the docs for yanked crates for the latest version. It would be nice to add a badge saying that the crate has been yanked e.g. on https://docs.rs/crate/futures/0.2.3-docs-yank.4.

[jyn514]

Oops, I think that might have been done by futures in their docs actually. We have a long way to go for handling yanks 😅

See also #112, #322 , #561

[Nemo157]

@sunjay with #614 fixed so that the yanked status of 0.1.* is updated, do you still want the docs fully removed? The old versions show warnings that they are yanked and suggest redirecting to the prereleases.

[sunjay]

@sunjay with #614 fixed so that the yanked status of 0.1.* is updated, do you still want the docs fully removed?

Yes, that would be great. Those versions were for a different crate that used to use that name. Removing them will avoid some confusion so please do that. Thanks!

[jyn514]

We have a way to delete entire crates (delete-crate), but it sounds like you're asking for specific versions to be removed which is a little harder.

[sunjay]

Yes. I only want the 0.x versions removed. Back when this issue was created those were the only versions. 😅

[pietroalbini]

I'm wondering if we should just hide the documentation of all yanked crates.

[jyn514]

Currently what we do is we don't show them unless you explicitly go to the link, and all the links to it have a big warning sign in addition to the 'this crate has been yanked' banner.

We could also hide the link to the yanked version if you like, but I'm starting to question how applicable this is to other use cases, it seems a little specific to turtle.

[sunjay]

Yeah I'd be fine with them just being deleted for the turtle crate. I can see why building something more general might cause unexpected issues.

[Kixiron]

I'm not necessarily against hiding (and potentially deleting, we need to do an audit of how much space is taken up by yanked crates) yanked docs, but it'll inevitably bring up the question/objection that we aren't supposed to be the ones who decide that docs aren't shown. Like I said, I'm not against it though, as I personally feel like someone who's using yanked crates can be reasonably expected to build docs locally and I think it'd get rid of what is basically a class of issues and considerations that have to come up so often