correct typos and add clarifications in Vector docs
Merge pull request #181 from ellemenno/docs/BJG-Jul14-2014-DocsPass

correct typos and add clarifications in Vector docs