fix doc typo and add highlighting for times_in_seconds