revisit documentation and improve

e.g.
```
vl-db-agent provides the opportunity to store Result to different locations
 in one request. This is done by means of a using a vector for DocPath 
instead of a string. If DocPath is a vector it must have the same length as Result.
```

what?