vector: improve documentation