Further changes to make the README easier.

Primarily aimed at new people -- provide some idea of what a 'vagrant
box' is, add the instruction to run the commands in backtick quotes.
Also detect and error about puppet fails.

This is more likely than any other failure, but it's unclear if we
don't error about it upfront.