Improve docs for std::vec

Random improvements to the `std::vec` docs.
Huh? But these are both inner comments right? They should show up in the same place?