clarify time_spent, and note that it should be an integer