Refactor: tools: best practices for crm_resource's max_delay_in()

Rename to wait_time_estimate() to better reflect its purpose, add a doxygen
block, and improve log messages, comments, and formatting.