Simplifying README

- moving bits in the `demo` folder
- moving bits in the `doc` folder