typo and better comments
(#467)