extended the readme with more advanced examples
cleaned-up logs and comments