[misc] improve comments