View all Signals

Improving feedback in code reviews

If you’re involved in any kind of review process, whether it’s code, writing, or design, Conventional Comments offers a structured approach to giving feedback.

By prefixing comments with clear labels like suggestion:, issue:, or praise:, and optionally adding tags like non-blocking:, reviewers can make their intent clear. This helps reduce misunderstandings, encourages constructive dialogue, and makes comments easier to scan or parse programmatically.

conventionalcomments.org