Improve docs for std::vec

Random improvements to the `std::vec` docs.
I was trying to incorporate the previous documentation, but yeah, maybe this is just redundant.