Structured comments that can simplify and speed up PR reviews in teams

Marcin Konkel
2 min readJan 9, 2023

Comments on pull requests are, in some teams, a topic of heated debate. Depending on the team, they can become blurry or start fiery discussions due to missing human ques in situations where people don’t or can’t talk to one another. This can be due to setup or difference in time-zones.

There seems to be a solution through an initiative called “Conventional Comments”. The idea is to quickly indicate the intention of one’s comment using a specified structure:

<label> [decorations]…

--

--

Marcin Konkel

I talk about fostering hyper-productive teams and focused orgs where people and products flourish 🚀 Helped 100+ teams to grow 🌱 Mentor to Scrum Masters 🦸