updated readme and example

ready for review @TiddoLangerak 
I disagree, the is now more compleet as both a fail as a success scenario is in place