Comments should either be like a newspaper headline, describing the general gist of a section, such as "hide low-ranking blog comments", or to point out odditie

Comments should either be like a newspaper headline, describing the general gist of a section, such as "hide low-ranking blog comments", or to point out oddities or surprises, such as "for unknown reasons this API doesn't like single quotes" to explain why converting characters is done.