replace a verbose reimplementation of 'vector
better story
add examples of expanding schema for debugging, tweak headings
add steps and renumber accordingly
fix tests