Improve docs for std::vec

Random improvements to the `std::vec` docs.
These lines are prefixed with `//!` when they should be prefixed with `///` (to attach to the `Vec` struct below).