When an earlier phase changes
What the "Based on older versions" pill means, and how to confirm that a finished phase or story still holds for a newer version of an earlier phase, or start its next version instead.
Updated
Every committed version records the versions it is based on: a phase, the phases before it; a story, Discovery, Exploration and Planning. When one of them gets a newer version, your version is behind. You decide whether it still holds.
Two ways on
- It still holdsResolve the markers the change left and confirm the version. No new version, no change to its content.
- It must changeStart the next version. It is based on the newer versions by itself.
Spot it
A finished version without an open draft shows the pill "Based on older versions" in the bar above the artifact. The phase tab says, for example, "Based on an older version of Discovery" when you point at it.
See what is newer
Click the pill. "Version N is based on" lists each earlier phase, for example "Discovery · version 1 · version 2 is newer", with the newer version’s commit comment and where it stands:
- "N markers still open. Resolve them first."
- "No marker from it is open."
- "Up to date." or "Confirmed still valid by …" for a phase that is not behind.
Below, "Does version N still hold?" sums up the two ways on.
Confirm that it still holds
"Show N markers" opens the markers the newer version left. Resolve them, see Resolve items marked for review. Markers set by hand do not hold the confirmation back.
Then choose "Confirm for Discovery 2", for example. The button names every earlier phase that can be confirmed and reads "Nothing to confirm yet" while none can. Any member of the project team can confirm. The version keeps its number; the version history now reads "Based on Discovery 2 (confirmed by …, date)".
Or start the next version
"Start version N+1…" opens the usual dialog. It says what the new version is based on, for example "Version 3 is based on Discovery 2.", and that open markers move along: change what they point to, then mark them handled.
While the draft is open, a line above the artifact says what it is based on and that version N stays based on the older versions. See Versions and drafts.
Not during a draft
While a draft of the next version is open, the pill is hidden and nothing can be confirmed: committing the draft bases it on the newer versions.
If it changed meanwhile
If yet another version of the earlier phase was committed while you looked, Speclr refuses with "… has a newer version than the one you confirmed" and asks you to look again.
What is recorded
Each confirmation keeps who confirmed it, when, and for which version. Both version histories, of phases and of stories, show it.
