clarifying tools.py usage and noting required logging to be done