Expand description
The managed blocks in review descriptions: the user’s description, the
issue-closing link, and the stack-overview ledger ([ledger]), all
built on marker-delimited [sections].
Functions§
- seed_
template_ notes - Prepare each freshly created review’s body before the managed sections go in. Create-only - existing reviews keep whatever body they have.
- update_
closes_ notes - Add a
Closes #Nline to each branch’s review when the branch name references an issue (e.g.123-fix-thing,fix/issue-123), so the platform closes the issue when the review merges. Branches without an issue reference are passed over silently. - update_
description_ note - Write (or, with an empty string, clear) the description block in the
branch’s review body. Unlike the stack overview the block is sticky:
submits without
--descnever touch it. - update_
stack_ notes - Maintain a stack overview in every review body, one independent stack at a
time: a PR’s overview must list only its own stack, never sibling stacks
that merely share the trunk.
branch_parentscan span several such stacks (e.g. asyncrun from the trunk), so group by each branch’s child-of-trunk root and refresh each group’s notes on its own.