Adress Olivier's comments

* extended narrative doc
* don't copy vector twice