Topics

Revisions


In This Guide

Creating a revision

After you publish an asset, you can create revisions to the published version, and you can also create revisions from past revisions.

To create a revision:

  1. Do one of the following:
    1. Create a revision from the currently live version—In the Revisions widget, click Start New Revision.
    2. Create a revision from a previous revision—In the Revisions widget, under Named Past or Past, click the revision on which you want to base the new revision.

    Brightspot loads the selected revision in the content edit form.

  2. In the Revisions widget, click Start New Revision. The New Revision widget appears.
    new-revision-Create-Revision.png
  3. Type a name for the revision and click Create. Brightspot does the following:
    1. Adds the new revision to the Revisions widget.
    2. Lists the new revision in the Recent Revisions banner when editing previously live revisions.
  4. Under Edit, modify the revision. You can compare the new revision with the previous one under the Side By Side tab.
  5. Click Publish.

The following example shows that a revision is in progress.

new-revision-content-edit-form.svg

The following example shows the list of recent revisions that are not yet published.

recent-revisions-banner.svg

Recent revisions appear in the banner if they were updated within the last 24 hours. You can configure the window for recent revisions; for details, see Settings for the Global site.


Naming a revision

By default, Brightspot labels revisions with a time stamp and a username. You can also add a descriptive name to a revision.

To name a revision:

  1. Search for and open the asset in the content edit page.
  2. In the Revisions widget, click the revision you want to name. A status bar appears at the top of the content edit form.
    revision-status-bar.png
  3. Click Name Revision. The Name Revision widget appears.
    name-revision.png
  4. In the Name field, type a name for the revision.
  5. Click Save.

The revision’s name appears in the Named Past section of the Revisions widget


Deleting a revision

You can delete in-progress revisions.

To delete a revision:

  1. Search for and open the item in the content edit page.
  2. In the Revisions widget, under In Progress, select the revision that you want to delete. Brightspot loads the revision in the content edit form.
  3. Click settings, then click Delete Revision.
  4. In the confirmation prompt, click OK.

Updating in-progress revisions

You can update a revision prior to its publication. If you want to issue a new revision to one that is already published, see Creating a revision.

To update an in-progress revision:

  1. Search for and open the asset in the content edit page. The Revisions widget lists the available in-progress revisions, if any. For an example, see the illustration Revisions widget.
  2. Click the revision you want to update. Brightspot loads the revision in the content edit form.
  3. Under Edit, modify the revision. You can compare the new revision with the previous one under the Side By Side tab.
  4. Click Save.

Comparing revision to live version

You can compare a revision to the currently live revision.

To compare a revision with the live version:

  1. Search for and open the item in the content edit page. The Revisions widget lists the available revisions.
  2. In the Revisions widget, select the revision against which you want to compare the live revision.
  3. Under the editorial toolbar, click Compare to Live.

Brightspot opens the revision in the content edit form, and displays the differences between it and the currently live revision. For an example, see the illustration Comparing a draft or revision with the live version.


Merging revisions into draft

If you have a draft that is already in a workflow, you can update the draft without restarting the workflow. The following scenario provides an example.

  • Mary creates a draft, and sends it to the first status in the workflow “Fact-Checking.”
  • The next day, Mary realizes that she needs to update the draft, so she creates a new revision from it.
  • While Mary is working on the new revision, John completes the workflow’s fact-checking stage and moves the draft to “Proofreading.”
  • Mary finishes her new revision, and merges it into the draft. The draft remains in the “Proofreading” status—instead of going back to “Fact-Checking.”

To merge a previous revision into a draft:

  1. Search for and open the asset in the content edit page.
  2. In the Revisions widget, click the draft you want to revise. The draft must be in a workflow.
    drafts-in-workflow.svg
    Brightspot loads the draft in the content edit form.
  3. In the Revisions widget, click New Revision. The New Revision widget appears.
    new-revision.png
    1. Type a name for the revision and click Create. Brightspot adds the new revision under In Progress in the Revisions widget (see the illustration New revision in content edit form).
    2. Under Edit, modify the revision. You can compare the new revision with the base draft under the Side By Side tab.
    3. Save the revision by clicking save.
    4. Wait until the base draft advances in the workflow.
    5. Click Workflow, and in the Workflow widget, click Merge with Draft.
      workflow-widget.png

      Revisions widget

      After you save the first draft of an asset, Brightspot displays the Revisions widget in the content edit page. This widget lists all drafts, the currently live version, revisions that are not yet published, and previously published revisions. For each version, the Revisions widget lists the time it was saved and the user who saved it. The following illustration provides some examples of entries in the Revisions widget.

      Revisions Widget: Revisions