Improve docs for std::vec

Random improvements to the `std::vec` docs.
Maybe my smug programmer is showing but this feels weird to assert. (also vaguely ambiguous if it's a Vec<&T>)