Document comments have become a key element of how we give and receive feedback from colleagues, but have you ever stopped to think about your approach?
In the world of distributed work, live documents and comments have become key to how software engineers collaborate at work. But poor comments etiquette can negatively impact colleagues, hamper collaboration, and complicate important decision making.
Good comments etiquette should follow the same principles of collaborating effectively offline, such as:
- Listen fully and presently
- Confirm alignment and understanding
- Collect your thoughts before responding
- Provide actionable feedback
- Agree on next steps
These key principles don’t change in a collaborative doc.