comments and detailed logging