Keep your decisions13 / 20
Look back at every version
On this page
Every change to an Intent Document is kept. Pick a version to see which documents it changed and what changed in each, whether you made the edit or the Agent proposed it and you accepted, and how the text was explained at the time. How you came to decide it is all still there.
Open version history
There are three ways in:
- Hover over the “intents” heading in the sidebar and click the history button.
- Choose View → Version History, or press
⌘Y(Ctrl+Yon Windows and Linux). - In a note that says “This explains the previous text”, click “View in version history”.
The first two only switch the sidebar and select the latest version; the main area stays as it is. The third selects the latest version that changed this document, and replaces the current document in place with that version of it.
While you're in history, tabs, side-by-side layouts, the code panel and chats in the main area work as usual. Click “Exit version history” at the top of the sidebar to return to the normal sidebar; the history tab closes with it.
Where versions come from
Each change to your Intent Documents is a version. By source, they are:
| Source | Title in the list |
|---|---|
| You accepted a proposal | The proposal's title, such as “Email the team owner when the grace period starts” |
| You accepted an organization plan | Organized |
| You saved in Noea, or changed the files outside Noea | Manual edits. Consecutive manual edits merge into one version until the next Explain finishes |
| Every changed document went back to a state already recorded | Back to “the title of that version” |
| The documents as they were when recording began | Recording started |
Read the version list
In history, the lower part of the sidebar becomes the version list, grouped by day with the newest first. Each version takes two lines: its title, then its time, a status icon, a source icon and how many documents it changed, such as “2 documents”.
- Time: a manual-edits version shows the span from its first to its last edit, marked “In progress” until it closes.
- Status: explained, being investigated or not explained yet, that is, whether this version's text has its explanations; hover to see which.
- Source: tells your edits apart from the Agent's; going back to an earlier version has its own icon.
The upper part of the sidebar is still your document tree, nested and expanded as before. Documents the selected version changed are marked:
| Change | Mark |
|---|---|
| Created | A green dot beside the name |
| Modified | A yellow dot beside the name |
| Deleted | Listed where it last was, struck through in red and dimmed |
| Renamed | The new name, with the old one faintly beside it |
Open a document as it was
Select a version and click a document in the tree; the main area opens it as it was in that version. A history document is read-only, with a lock beside its title that tells you which version it is when you hover; the layout, outline, find and notes work as usual, and you can select and copy the text.
The document marks what this version changed from the one before, in the style of review mode: added, rewritten and deleted, with deleted paragraphs left in place. You can step through them at the bottom.
If this version didn't change the document, you see its content as of the last change before it, with the time it comes from. If the document didn't exist yet in this version, or this version deleted it, that is said too.
When you select another version, an open history document follows, showing the same document as it was in that version. A window has one history tab at a time.
See the explanations of the time
Each paragraph in a history document shows the explanation for that version's text. If the paragraph was later rewritten or deleted, its note opens with “This explains this version's text”: it explains the text as it was then, not the document as it is now. Paragraphs this version hasn't explained are marked as not explained yet, and those under investigation as being investigated.
This lets you answer “why was it implemented that way back then?” For example, when the grace-period proposal was accepted three weeks ago, its explanation listed the choice of counting 7 days as 168 hours; only later was it changed to calendar days in the team's time zone.
If you want an earlier version back
Version history is for looking back; it has no “restore this version”. To bring something back, copy the text from the history document, paste it into the current document and save; or ask the Agent in a chat to draft a proposal that changes a paragraph back to its earlier wording, and accept it once you've reviewed it.
If you keep your intent folder in Git, you can also restore files with Git. When every document returns to a recorded state, the version list shows an entry titled “Back to …”.