Revision History

^{New 7.12}

Edit an Article with confidence. Every time you click Save, Nodinite stores a revision of the Article, so a mistaken edit, a rewrite you regret, or a Document Profile change is always one click away from being undone.

• ✅ Every Save stores a revision, with who saved it and when
• ✅ See at a glance which saves changed the Article's Document Profile
• ✅ Restore an earlier revision from the History card
• ✅ Start a new document from an old revision, and leave the live one untouched
• ✅ Compare any revision with another one, side by side
• ✅ Purge old revisions for many Articles at once when you no longer need them

Understanding Revisions

A revision is a stored copy of an Article as it was at one Save. Revisions are kept per Article, numbered from 1 upward, and listed newest first.

Blue actions create revisions, green shows where they're kept and opened, teal is what you can do with one revision (restore it, clone a new document from it, or compare it), and red Purge revisions removes them for good.

The History Card

Open an Article in the editor (Action > Edit on the Articles Overview) to see its History card on the right, below Categories, Applications, and Resources. The number in the card header is the number of stored revisions.

The History card sits below the association cards; Compare in its header opens the compare tool.

Each entry shows the revision number, the user who saved it, and the date and time. When a save changed the Article's Document Profile, the entry has a Profile changed badge, and the name of the profile the Article moved to.

Revisions 2 and 3 changed the Document Profile; Revision 3 also names the profile the Article moved to.

Click Compare in the card header to compare this Article with another document, or with one of its own revisions; see Compare Articles.

The Revision Dialog

Click a revision in the History card to open it. The dialog shows the revision against the Article's current text, with the changes marked inline:

• The header names the revision, with a Profile changed badge when that save changed the Document Profile. Use ‹ and ›, with the counter such as 4 of 6, to step to the previous or next revision without closing the dialog.
• The line under the header says when and by whom the revision was written, and the Article's title and Document Profile at that time. It also reminds you how to read the changes: Removed lines are what the revision has and the current text does not.
• A profile-based Article has the tab Whole document (composed), plus one tab per Content Part. A part that the current Document Profile no longer has is marked (no longer in the profile).

The revision dialog: read what changed, then decide what to do with the revision.

Restore a Revision

Choose Restore whole document to put the Article back to the revision. Use it to undo an edit, or to bring an Article back to how it looked before a Document Profile was applied. The Article's text before the restore is stored as a revision too, so a restore can itself be undone.

Tip

Applying a Document Profile to many Articles at once has no bulk undo, but it stores a revision of each Article first. Restore any Article you want back from its History card, one Article at a time. See Apply Document Profile.

Clone from a Revision

^{New 7.12} Sometimes an old revision reads better than what the Article became, but you don't want to overwrite the live Article. Clone from this revision creates a new document of the same kind that starts from the revision's text, and leaves the source untouched.

1. Open the revision from the History card, and click Clone from this revision.
2. The Clone Article from Revision N dialog suggests the name <title> (from Revision N). Change the Name if you like; it must be free. The line under it says which revision the new document starts from, when it was written, and by whom.
3. Tick Copy the history up to this revision to give the new document revisions 1 to N of the source, with their original authors and times. It's off by default, so the new document starts with an empty History card.
4. Click Duplicate. The new document opens in the editor.

Copy the history is off by default; leave it off for a clean start, or tick it to keep the story of how the text came about.

The new document gets:

• the revision's Main Body, and each Content Part that the source's current Document Profile still has. Parts the profile no longer has are skipped, and the result lists them, as for a restore.
• everything else a Duplicate copies: Tags, links, Custom Metadata, and the Document Profile.
• a Cloned from relation to the source Article, and an audit line that names the source, the revision, and how many revisions were copied.

Clone from this revision needs Create on Articles in the Permission Set for the Repository Model, and works for Articles, Snippets, and Templates. It isn't offered for a Document Profile, whose revisions hold its structure only.

Revisions in the Articles Overview

The Revisions column on the Articles Overview shows the number of revisions next to a history icon, so you can see which Articles have history without opening them. The column is empty for an Article without revisions.

Revision counts in the Articles Overview; Articles without a number have no stored revisions.

Purge Revisions

Revisions take up storage. When you no longer need the history of some Articles, select them on the Articles Overview and choose With Selected > Purge revisions. The number on the menu item is the number of selected Articles, not the number of revisions.

Purge revisions counts the selected Articles whose history it removes.

To purge a single Article, choose Purge Revisions in its Action menu on the Articles Overview; there the number is the Article's own revision count.

Choose what to remove, then click Purge:

The Articles themselves don't change; only their history is removed.

The result lists every selected Article and how many revisions were removed from it. An Article without revisions is still listed, with Removed 0 revisions.

Every selected Article is counted as purged, even the ones that had no revisions to remove.

Warning

Purging can't be undone. Removed revisions can no longer be compared or restored. The Articles themselves are not changed.

Next Steps

• Compare Articles – Compare two revisions or two documents side by side
• Bulk Actions – Purge revisions, delete, restore, tag, and apply a Document Profile to many Articles at once
• Add or manage Article

Related Topics

• Knowledge base Articles
• Document Profiles
• Writing a Profile-Based Article
• Articles Overview
• Show deleted records
• Move many Articles onto a Document Profile at once — with a revision saved first