tweaks to logging doco from @mauroservienti