doc: more consistent comments about vectors.