I won't move pygame.math.Vector2/3 into pygame or pygame.locals namespace for now.
That's potentially breaking things which already have their own Vector2/3.
This type of API change will wait for pygame 2.
Narrative documentation is missing, and I'm working on that now.