add examples, improved logging