add demo, caveats and FAQ to the readme

This resolves #5 and #10