Topics

Drafts


In This Guide

Creating a draft

The first state of an asset is Draft. You can create multiple drafts for an asset before publication, compare the changes between two drafts, republish an asset based on a previous draft, and merge a later draft into an earlier one.

To create an initial draft:

  1. In the Quick Start widget, click the content type for which you want to create a draft. The content edit form appears.
  2. In the content edit form, start authoring the asset.
  3. In the editorial toolbar, click save.

After you save an initial draft, the content edit page starts tracking information about the asset’s drafts.

Article draft example.png

Referring to the previous illustration—

  • The Revisions widget appears in the content edit page listing the initial and subsequent drafts.
  • The color of the border under the editorial toolbar indicates the asset’s state.
  • The initial draft remains in the content edit form.

Work in progress

As you create or modify an asset in the content edit form, Brightspot continually performs background saves to prevent loss of data. For example, if your browser window closes before you save or publish your latest changes, Brightspot recovers them from the background saves.

Brightspot indicates a background save is complete with a (Work in Progress Saved) message in the editorial toolbar.

Work in progress saved notification.png

When you see the message Clear Changes in the editorial toolbar, you can do one of the following:

  • Click save to save the current content in the content edit form, which includes the background saves.
  • Click Clear Changes to revert the content edit form to the version you last saved or published.
    Clear changes message.png

Creating additional drafts

To create additional drafts:

  1. Search for and open the item in the content edit page.
  2. In the Revisions widget, select a draft from which you want to create a new one. The draft’s information appears in the editorial toolbar.
    Draft information.png
    1. Modify the item.
    2. In the editorial toolbar, click save.

    Brightspot saves the new draft, and lists it in the Revisions widget.

    Comparing a draft with the live version

    You can compare a draft to the currently live revision.

    To compare a draft with the live version:

    1. Search for and open the item in the content edit page.
    2. In the Revisions widget, select the draft that you want to compare with the live version. The draft appears in the content edit form.
    3. Under the editorial toolbar, click Compare to Live.

    Brightspot displays the differences between the selected draft and live version.

    Comparing draft differences.png


    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

        Republishing from draft

        If you need to substantially update a published asset, it may be more efficient to return to a previous draft than to start an entirely new draft.

        Warning
        When you republish from a previous draft, Brightspot temporarily removes the published asset from your site, and visitors will not be able to view the asset. Visitors will be able to see the asset after you publish the new version.

        How to republish from a draft:

        1. Search for and open the asset in the content edit page.
        2. In the Revisions widget, select one of the versions labeled Draft.
          revisions-widget.svg
        3. Click save. Brightspot creates a new draft in the Revisions widget, and retains the new draft in the content edit form.
        4. Under Edit, modify the asset.
        5. Click Publish.

        Brightspot publishes the new version that visitors now see.