revised demo walkthrough and readme updates