simplified vector operations & their docs