Versions and drafts
How a finished phase or story changes through a draft of its next version: starting and discarding drafts, deciding what a change affects, markers for review, and older versions.
Updated
How versions work
- Committed versions stayA committed version never changes. You can always open it again.
- One draft at a timeEach phase and each story has at most one draft of its next version.
- The rest keeps workingLater phases and other stories use the committed version until the draft is committed.
Start a new version
In a finished phase or story, choose "Start version N+1…" below the conversation. The dialog "Start a new version of …" shows the current version beside the new one. Choose "Start version N+1".
The draft starts as a copy, all session modes are available again, and team votes start fresh.
Work in the draft
The bar above the artifact shows the version, a "Draft" pill and who started it. Edit and run sessions as in the first run.
The "Changes" button beside the artifact shows what changed since the last version and what it may affect. See What changed and what it may affect.
Decide what the changes affect
When the changes reach a later phase or another story, you decide for each element there whether it gets a marker for review. See What changed and what it may affect.
Commit the draft
The finish step of a draft with changes shows the change plan first and commits once every element is decided. The new version replaces the old one for everything that reads it. See Finish a phase.
Markers for review
The commit puts a marker on every element marked for review. Unresolved markers, postponed ones included, block finishing. See Resolve items marked for review.
Based on older versions
When an earlier phase has a newer version, a finished version shows "Based on older versions": confirm that it still holds, or start its next version. See When an earlier phase changes.
Discard a draft
"Discard draft…" removes everything changed in it. The committed version stays. Any team member can discard, but not while a session is running.
Version history
Click "Version N" above the artifact. A draft shows "Not committed yet."; each committed version shows its comment and who committed it. "Open version N" shows it read-only; "Back to version N" returns.
