some logging tweaks
added some examples and the first bit of documentation