gold plating README
updating examples and comments
cleaned up substep functions, added events
more gold plating for demo