documentation: vector revamp