Reviews & Discussions
Change requests support rich code review workflows with threaded discussions, inline suggestions, and formal review states.
Review States
When submitting a review on a change request, you can choose from several states:
- Approved — You approve the changes and they are ready to merge.
- Changes Requested — You are requesting modifications before approval.
- Commented — You are leaving general feedback without a formal approval or rejection.
- Blocked — You are blocking the merge due to a critical issue.
- Dismissed — A previous review has been dismissed.
Discussion Threads
Threads are discussions that can be created on a change request. They support:
- General comments — Open-ended discussion on the CR.
- Inline suggestions — Comment on specific lines of code with suggested replacements.
- Issue threads — Track issues that need to be resolved.
- Automated threads — Created by the system (e.g., when a state changes).
Thread Status
Each thread can be in one of these states:
- Open — Active discussion.
- Resolved — The issue has been addressed.
- Closed — The thread has been closed without resolution.
Thread Messages
Threads can have multiple messages, allowing back-and-forth conversation between reviewers and the author.