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.
