Documents
Review Workflow
Review Workflow
Type
Document
Status
Published
Created
Mar 27, 2026
Updated
Mar 27, 2026

State at PR Open Merged#

Doc typedefault_accept_reviewcommit_to_trigger_prState before mergeAfter merge
TopicanyanyPENDING_REVIEWAlways auto-accepted → null
GitONONPENDING_SYNCAlready committed to source PR branch at open. Source PR merge triggers file sync → null
Git-backedONOFFPENDING_SYNCSync PR was already opened at PR open. Resolves to null when that sync PR merges.
Git-backedOFFONPENDING_REVIEW (edge case)Auto-accepted → PENDING_SYNC. Source PR now merged, so commit_to_trigger_pr always falls back to new sync PR off default branch.
Git-backedOFFOFFPENDING_REVIEWNo change — stays in Review queue. User has to manually accept then it will be in pending sync and create sync PR -> on merge sync PR -> null
Confluence / NotionONPENDING_REVIEWAuto-accepted → null + write-back
Confluence / NotionOFFPENDING_REVIEWNo change
Internal docONPENDING_REVIEWAuto-accepted → null
Internal docOFFPENDING_REVIEWNo change

Chat Update#

Doc typedefault_accept_reviewState after updateWhat happens next
Topicanypublished=true, nullImmediately live — topic override hardcodes this regardless of settings
Git-backedONpublished=true, nullImmediately live in Dosu. No git sync triggered (no PR context)
Git-backedOFFPENDING_REVIEWReview queue. On human accept → PENDING_SYNC → new sync PR created
Confluence / NotionONpublished=true, nullImmediately live + write-back to Confluence/Notion triggered
Confluence / NotionOFFPENDING_REVIEWReview queue. On human accept → null + write-back
Internal docONpublished=true, nullImmediately live
Internal docOFFPENDING_REVIEWReview queue. On human accept → null