improve documentation, update README for demo instructions