Start to add documentation to readme.
Make starting the audio stream a seperate function.  This should play
nicer with hardware, where the start function will need to block.
Lots more added to the README.
Fixes to the README examples.
Merge branch 'update-readme'