improve documentation

fixes #1391

and add improvements/fixes to documentation
Tnx for the suggestion. I'll include this in the log example directly and remove this boilerplate file as it's not used anymore..