Topics

Authoring content


In This Guide

Overview of the publishing process

The publishing process is a series of steps through which you create, review, publish, and archive content. This section describes various publishing workflows, as well as the different steps in the publishing process.

Publishing workflows

Every electronic publishing or media company that uses Brightspot has its own workflow for publishing content—often using different workflows for different types of content. In a simple workflow, an editor creates and then immediately publishes an item. After some time, the editor archives the item.

A simple workflow may be appropriate for very small media companies that don’t have dedicated reviewers, or for low-impact items such as tags.

In a complex workflow, an editor creates an item and sends it for review—possibly for more than one iteration. When the review is complete, Brightspot checks if the item is scheduled for immediate or future publication, and publishes the item accordingly. After some time, an editor archives the item, and updates all other content that refers to the archived item.

Workflow diagram.svg

A complex workflow may be appropriate for high-volume media companies with large readership, or when publishing high-profile content that requires extra measures of quality control.

Brightspot supports the above simple and complex workflows, as well as most other workflows for electronic publishing. For information about designing a workflow for your organization, see Workflows.

Adding or updating content

You can create or upload almost any type of digital content, such as articles, blog posts, images, videos, or files. You create and review content in the content edit page. One aspect of creating content is leveraging other content already in Brightspot. For example, if you have a rich library of science-related images, you can write a story about astronomy and include an image of Saturn that someone else previously added to Brightspot.

You add or update content in the content edit form. A form typically consists of several fields, and can vary depending on the asset type. The following example shows only two of the fields for an article, the headline and body.

Adding content.png

The following table lists the basic field types available in a content edit form. Your version of Brightspot may not have all of these field types, or may have other types that are extensions of these basic types.

Field TypeDescription
Text
Adds text with no formatting.
Markdown
Adds text with simplified formatting.
Rich text
Adds text, complex formatting, images, videos, and hyperlinks. For detailed information about using the rich-text editor, see Rich-text editor.
Date widget
Selects a date.
Toggle
Provides a yes/no or on/off indication.
Selection
Displays one or more options for selection.
List
Adds one or more items of the same content type to a list.
Image or File
Adds an image or file to Brightspot. For detailed information adding and editing images, see Images.
Location
Shows a location on a map.
Region
Shows a region on a map.
Query
Selects or designs a custom query to search for content.

Reviewing content

You can configure Brightspot to accommodate almost any reviewing workflow, such as the following scenarios:

  • An editor creates an item, and then revises the item the next day.
  • A reviewer opens an editor’s original item, makes changes as necessary, and immediately publishes it.
  • A reviewer opens an editor’s original item, recommends updates, and returns the item to the editor.

Brightspot’s reviewing workflows incorporate messaging (email, text, browser notifications) and conversation, so editors and reviewers can collaborate seamlessly on all modern platforms.

Regardless of your review workflow, every time you save an item, publish an item, archive an item, or change an item’s status as part of a Workflow, Brightspot saves the item as a revision. You can retrieve an item’s current or previous revision, modify it, and publish it; for details, see Revisions.

Publishing content

When you publish an item, Brightspot first applies layout and formatting based on various configuration settings. (What you see in the content edit form has little to do with how your item actually appears in a web browser.) Blog posts may have advertisements to the left and right of the body text, while videos may have advertisements above and below.

Next, Brightspot pushes the formatted item to the public Internet. Depending on your site’s business model, the content can be limited to subscribers, or it can be available to any visitor.

Archiving content

Nothing lasts forever, particularly in the digital world. Depending on your company’s policies, you can archive items so they are no longer viewable by visitors but remain in Brightspot. You can restore archived items or delete them permanently from Brightspot. (You can also customize Brightspot to automatically archive content.) Before archiving an item, you can check where it is referenced by other items and modify them accordingly.


Progression of an item through states

As an item moves through the publication process, Brightspot assigns it different states, such as draft, live, and archived. This section explains in detail how an item moves from one state to another.

When you open an item in the content edit page, you can perform a variety of actions. Each action transitions the item to a different state as summarized in the following diagram.

Progression of content through states.svg

Both the states and associated available actions appear in the Editorial toolbar (and in other places throughout Brightspot).

Content states toolbar.svg

Editorial toolbar showing states and available actions

Content states

The diagram Content actions and states lists an item’s possible states. The following sections describe each state and how an item enters and exits each state.

(none)

How an item enters this state

  • Starting a new item, adding text to fields, and before any actions such as saving or publishing.

How an item exits this state

  • Clicking save, the item enters the Draft state.
  • Clicking Publish, the item enters the Live state.

Draft

How an item enters this state

  • Clicking save when the item was in the (none) state.
  • Clicking save when the item was in the draft state, creates additional draft.
  • Restoring an item that was previously archived in this state.

How an item exits this state

  • Clicking Publish, the item enters the Live state.
  • Clicking calendar_today and selecting a date, the item enters the Scheduled state.
  • Clicking settings> Delete Permanently deletes the item.

Revision

How an item enters this state

  • Item is in the (none) or Draft state, clicking Workflow. Items remain in a workflow as they transition from one status to another. The status of a workflow appears in the content edit form.

How an item exits this state

  • Clicking Publish, the item enters the Live state.
  • Clicking calendar_today and selecting a date, the item enters the Scheduled state.

Workflow status

Scheduled

How an item enters this state

  • Clicking calendar_today.

The status of a scheduled item appears in the content edit form.

How an item exits this state

  • Clicking calendar_today> Clear, then clicking Publish. Item enters the Live state.
  • The scheduled date arrives, the item enters the Live state.

Live

How an item enters this state

  • Clicking Publish. The item’s scheduled date arrives.
  • Restoring an item that was previously archived in this state.

How an item exits this state

  • Clicking Publish for a different revision. The scheduled date for a different revision arrives.
  • Saving a new draft of a previous draft.

Archived content

How an item enters this state

  • Clicking settings> Archive.

How an item exits this state

  • Clicking Restore, the item enters the Draft state.
  • Clicking settings> Delete Permanently deletes the item