Fix errors in the readme and add instructions for running the demo

[gregwhitaker]

This addresses issues that were reported on gitter with the documentation not being clear or incorrect on how to run the demo.