Document Extensions: Revisions

• Located within the Document View,
  the Revisions Tab displays the full trail of all revisions created for the document.
• From this tab, you can inspect each revision, manually force the creation of a new revision,
  and compare revisions to the live document version and to other revisions.

Revisions Tab

1. Document View > Revisions tab
   Click to display the document's revisions tab.
   Revisions are listed in the revisions tab by their creation time signatures.
   The current number of revisions is displayed in the tab header.
2. Create revision
   Click to manually create a new revision for this document from the Studio.
   A new revision will be created if the document doesn't already have a revision for the latest content.
   Learn here about forcing the creation of a new revision via the Client API.
3. Revision timestamp
   Click to inspect this revision.
4. Compare revision
   Click to compare this revision with the current live version of the document and with other revisions.

Click the revision timestamp to inspect the revision's contents:

Click to Inspect

The revision will be visible in the Document View,
but file editing will Not be available since revisions cannot be modified.

Revision Inspection

1. Revision
   The REVISION label indicates that you are viewing a revision and not the parent document.
2. Clone
   Click to create a document that copies the revision's contents.
   

   • Cloning the revision will open the 'new document view' with this revision's contents.
   • You can then save the clone under a new name to create a new document.
   • Saving the clone with the exact same ID as the revision's parent document will revert the document to this revision.
     
3. See the current document
   Click to return to the revision's parent document view.
4. Revision contents
   The content of the revision is displayed in read-only mode.

Click the revision's comparison button to compare it with other revisions:

Click to Compare

Revision Comparison

1. Exit revisions compare mode
   Click to exit the comparison window and return to the revisions tTab in the Document View.
2. Compare with
   Click to select a revision to compare with.
   
3. Left-hand revision
   The left-hand view displays the revision selected in the revisions tab.
4. Right-hand revision
   The right-hand view displays the revision selected using the "Compare with" drop-down list.
5. Summary line
   This line summarizes the differences found between the two revisions.

• This view displays the revisions of deleted documents.

• When a document is deleted:

  • A "delete-revision" is created for the document, marking its deletion.
  • The "delete-revision" and all the document's revisions - whether automatically created due to the defined revisions configuration or manually created - are moved to the Revisions Bin.
  • This applies regardless of whether a revisions configuration is enabled or disabled.

Revisions Bin

1. Revisions Bin
   Click to open the Revisions Bin view.
   Each item listed in the Revisions Bin view references all the revisions created for a deleted document.
2. Selection boxes
   Check to select items.
3. Delete
   Click to remove selected items.
   Deleting revisions from the Revisions Bin will permanently dispose of these revisions,
   making them irrecoverable.
4. Deleted document ID
   This is the ID of the document that was deleted.
   Click it to inspect the revisions created for this document,
   known as "orphaned revisions" since their parent document has been deleted.
   • Revisions stored in the revisions bin can be inspected and cloned just like the revisions of a live document.
5. Change vector
   The change vector of the revision that was created for the document when it was deleted.
6. Deletion date
   The date/time when the document was deleted.

Restoring revisions

Giving a new document the ID of a deleted document whose revisions are kept in the Revisions Bin,
will restore the revisions from the bin and add them to the new document.

Opening the document's revisions tab will display the whole audit trail, including the delete-revision created when the old document was deleted and the revision created when the new document was created.

Restored Revisions