enhanced logging and readme