Improve docs for std::vec

Random improvements to the `std::vec` docs.
Ahhhh I screwed up. Yes, these should be `///`