[code_review] Improve the quality of the comment examples

[suhaibmujahid]

Some comment examples are not ideal. They should be actionable and written in a tone that aligns with what we expect our tool to generate.