Replace manual rustdoc links with better ones

[clarfonthey]

A lot of code existed before rustdoc's intra-doc links existed, and this is reflected by the fact that the code mixes both styles of links throughout. This PR explicitly goes through all the doc links and fixes them to the new style.

Worthy notes:

1. In order to properly link the std crate when necessary (e.g. RandomState), the #![no_std] in the crate is replaced with #![cfg_attr(not(doc), no_std]. Under pretty much all cases except rustdoc working correctly on newer versions of Rust, this should not affect anything, but it's worth pointing out.
2. Links to std::collections::hash_map::RandomState are replaced with std::hash::RandomState in docs only. Tests still reference the old path. While this will not work on the MSRV, it's better to recommend this path in documentation since people reading the documentation will likely be using newer versions of Rust, and anyone using earlier versions will still find the old path if they search for it in rustdoc.
3. Explicit links to the reference are still left in, since there's no standard way to mention them via rustdoc. (yet!)
4. This will also let people view documentation locally when browsing the crate in its entirety, since external crates like rayon can be documented locally instead of always linking to external versions.

[Amanieu]

Is there a lint that we can enable to check for broken doc links?

[cuviper]

Yes, rustdoc::broken_intra_doc_links -- which will also need a cargo doc run in ci.

[clarfonthey]

Also to clarify, rustdoc currently does have an unstable --check flag to just run lints, which we could probably get to run in CI if we wanted, but cargo doc is the easiest solution.

[Amanieu]

I would like cargo doc to be run in CI to check for broken doc links.

Other than that this LGTM but conflicts need to be resolved.

[clarfonthey]

Should be good now