Convert most of README into a single source file that lives in the Demo project

[kyleve]

Convert most of README into a single source file that lives in the Demo project – this allows us to compile the README, so if the build fails, we can not allow merging. A nice way to prevent stale documentation.