Edits to the VSO section

I expanded the first example, but it may now be too long; in the built PDF it is longer than a page, and is laid out at the end for some reason.