doc: revisions to vector.py