You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
In the documentation at https://rust-random.github.io/rand/rand/index.html, the list of crates in the left sidebar includes the crate rand_wasm_bindgen_test, which doesn't seem to have anything of interest to users. This crate should probably be marked to be excluded from the documentation.
This does not happen on docs.rs, so it seems to be specific to the way we build the docs. Maybe we can exclude that crate or do something like the following:
diff --git a/tests/wasm_bindgen/src/lib.rs b/tests/wasm_bindgen/src/lib.rs
index 9af0b9e..6afe76f 100644
--- a/tests/wasm_bindgen/src/lib.rs+++ b/tests/wasm_bindgen/src/lib.rs@@ -8,7 +8,7 @@
// Crate to test WASM with the `wasm-bindgen` lib.
-#![doc(html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk.png")]+#![doc(hidden)]
use rand::rngs::{OsRng, StdRng};
use rand::{Rng, SeedableRng};
It seems like we would have to replace cargo doc --no-deps --all --all-features with a command that ignores the WASM test crate, which requires listing all other crates explicitly.
"test" is in the name already. But if you prefer we can get rid of this. It's largely redundant with getrandom's testing, but there @josephlrfound a way of removing the separate test crate. (I guess it's just laziness on my part that this hasn't been done in Rand yet.)
Activity
vks commentedon Nov 29, 2019
This does not happen on docs.rs, so it seems to be specific to the way we build the docs. Maybe we can exclude that crate or do something like the following:
dhardy commentedon Nov 29, 2019
We can try that @vks. Care to make a PR?
Hide documentation of `rand_wasm_bindgen_test` crate
vks commentedon Dec 9, 2019
It seems like we would have to replace
cargo doc --no-deps --all --all-featureswith a command that ignores the WASM test crate, which requires listing all other crates explicitly.dhardy commentedon Dec 9, 2019
Indeed, and as I already said in #914 in my opinion it is better not to do this (i.e. live with this little issue). Do you agree @vks?
vks commentedon Dec 9, 2019
If we do this, we should maybe add some documentation that the module is internal and for tests only.
dhardy commentedon Dec 9, 2019
"test" is in the name already. But if you prefer we can get rid of this. It's largely redundant with
getrandom's testing, but there @josephlr found a way of removing the separate test crate. (I guess it's just laziness on my part that this hasn't been done in Rand yet.)vks commentedon Aug 24, 2021
I don't see
rand_wasm_bindgen_testanymore, so I think this is fixed.