tidy up doc and formatting in initialize_logging