updated demo, added readme.markdown notes