Provides rustc related crates that not in crates.io

[liigo]

Docs of HIR, MIR, etc. are useful for some developers.

[jyn514]

@liigo we have links to the standard library and a few other resource under the 'Rust' dropdown in the navigation panel. If you have any specific links you would like, feel free to open a new issue (or make a PR adding them yourself, mentoring instructions here: #137 (comment))

[liigo]

@jyn514 there's no rustc related api docs listed in the 'Rust' dropdown currently, so i don't think this issue is resolved.

[jyn514]

Ah sorry I misread rustc as rust.

[jyn514]

Mentoring instructions:

• In templates/navigation.hbs, add links to https://doc.rust-lang.org/stable/rustc/ and any other links you find helpful.

[liigo]

Thank you!

[jyn514]

Also, @pietroalbini are you comfortable adding links to rustc specifically? I know it's currently the only Rust implementation, but mrustc is a thing and I'm not sure if others are planned (in the far future) ...

[pietroalbini]

The link I think @liigo mentions is https://doc.rust-lang.org/nightly/nightly-rustc/rustc/.

I don't think adding the link itself is worth though: it's only needed for people working on the compiler, and it's shown on the home page of the contributor guide.

[jyn514]

Maybe it would be helpful to link to the contributor guide instead?

[pietroalbini]

Hmm, I still don't see much value in that, as a rustc contributor should already know that.

[jyn514]

Hmm, I still don't see much value in that, as a rustc contributor should already know that.

Speaking personally, I've made a couple PRs to rustc and I didn't know the contributor guide existed until recently. I don't think it hurts to advertise it a bit more.

[liigo]

Hmm, I still don't see much value in that, as a rustc contributor should already know that.

IMO if docs.rs is the home of all crates api docs, users would expect to find std and rustc api docs at the site. And they should be provided in the same way as other crates, not just in an external links list (the ‘Rust’ dropdown menu).

[jyn514]

docs.rs is the home of all crates api docs

But std and rustc are not crates, they are part of the compiler. Hosting std docs is significantly more difficult and expensive than hosting crates.io crates and we do not plan to support it anytime soon.

[jyn514]

BTW, you can go to https://docs.rs/std and it will redirect you to https://doc.rust-lang.org/stable/std/, which might be part of what you're looking for.

[jyn514]

Actually, maybe it would make sense to redirect rustc to https://doc.rust-lang.org/nightly/nightly-rustc/rustc/ as well? Not sure if rustc is a reserved name on crates.io.