[DOC release] comment examples and consistencies

Saw one typo, but got carried away..