@simon hmm, I think the Rust docs are pretty good (read Vec or something). Sometimes, the documentation is perfunctory. When there's a long comment, you know something is up. That helps a lot.

Compare Vec::with_capacity() to Vec::capacity(). https://doc.rust-lang.org/src/alloc/vec/mod.rs.html#949