updated readme and example

ready for review @TiddoLangerak 
If nobody has a problem with it, I could translate it to spanish ;)