rust-lang / docs.rs

crates.io documentation generator
https://docs.rs
MIT License
973 stars 193 forks source link

crate `std` and `rustc` should be searchable #604

Open liigo opened 4 years ago

liigo commented 4 years ago

https://docs.rs/releases/search?query=std https://docs.rs/releases/search?query=rustc

jyn514 commented 2 years ago

@liigo what is the goal of making those crates searchable? The first hit for "rust std" on google is already https://doc.rust-lang.org/std, and it's not like you can confuse the standard library with another crate.

liigo commented 2 years ago

Why not? They're all crates, I don't think some of them should be picked out to be not searchable in docs.rs.

dcormier commented 2 years ago

Coming from golang, I can say it's a really nice developer experience to be able to just go to the godocs and search for docs from any package, including the standard library. I often miss this when using docs.rs.

It took many months of Rust to get used to doing a separate search for stuff in std, but it's definitely not as nice as just searching where the docs are for all the other crates.

jyn514 commented 2 years ago

@dcormier this isn't asking about searching items within the standard library (like std::process or something - see #494) - it's about searching for crates called std. I'm not sure why you would ever do that instead of just typing docs.rs/std into the browser.

jyn514 commented 2 years ago

I don't think some of them should be picked out to be not searchable in docs.rs.

Well, it's not like we've intentionally singled them out - they aren't published to crates.io.

liigo commented 2 years ago

this isn't asking about searching items within the standard library

they aren't published to crates.io.

that was already requested but sadly refused

liigo commented 2 years ago

they aren't published to crates.io

they are published to an all-known position

edit: they are officially published to an all-known position

timthelion commented 2 years ago

I want this because I prefer not to use google and instead use firefox's multiple search engines feature. When I want rust docs, I use docs.rs search feature. I'm surprised that:

https://docs.rs/releases/search?query=std%3A%3Afs

Doesn't work.

jyn514 commented 1 year ago

FWIW https://docs.rs/std::fs redirects to https://doc.rust-lang.org/stable/std/?search=fs