Add usage, examples and events to README

Also tidied up the code comments a bit and modified `save.js` slightly to output better logging from the events fired.