Improve docs for std::vec

Random improvements to the `std::vec` docs.
Yes, but so that it shows up in both places.