Superdesk - Glossary and terminology guide
Reading through this list of Superdesk terms will help you better understand the user manual.
Action menu - Designated by a line of three small dots, an action menu provides options for actions like editing and deleting. Action menus appear throughout Superdesk. Clicking on an action menu will enable a pop-up menu with further options.
Activity Stream - A Dashboard widget which tracks tasks and item progress across all Desks. It can be customized for the number of items displayed.
Advanced Search icon - The Advanced Search appears on the Search tab, as well as the Legal Archive. Clicking on the Advanced Search icon allows you to define additional parameters for your search. The Advanced Search icon is shaped like a golf tee.
Article / Item - This is a generic term for any content in Superdesk including text articles, photos, videos, packages, etc.
Byline - A metadata field on an article which usually contains the author’s name and the date of creation.
Create icon - The Create icon is located in the top-right corner of the Superdesk interface. When on the Dashboard, it allows you to add widgets. From other Workspace Panel tabs, it allows you to create new items or import new items into Superdesk. Overall, the uses of the Create icon are context driven. You will see the uses vary in the settings menu and in the article editing window.
Custom Workspace - Your Custom Workspace is a private desk that you can create in the Desk menu. It’s a great way to creating custom Monitoring and a private Dashboard to suit your needs. Items created in you Custom Workspace will show up in your Personal Items tab in the Workspace Panel.
Content Profile - You can set up content profiles in the settings section of the Settings menu. Content Profiles define the metadata fields for new item creation within Superdesk.
Dashboard - You can access your desk Dashboard by clicking on the house-shaped icon in the Superdesk Workspace Panel. Your Dashboard provides an overview of content and information with customizable Widgets. Dashboard widgets on shared desks are set up by the desk admins. Custom Workspaces can be customized by each user for their individual needs. The shortcut to return to your Dashboard is (alt + h).
Desks - Desks are the basic organizational unit within Superdesk. They are similar to topic desks or news beats that would be found in a traditional newsroom; for example sports desks, foreign desks, etc. The Workspaces menu is the blue drop-down menu found to the right of the Settings menu icon. It always displays the name of the desk you are currently working on. Users can only view the desks to which they are assigned.
Editor Sidebar - The toolbar that appears on the right-hand side of the Superdesk interface when an article editing window is open. Available tools include Send To, Find and Replace, Packaging and others.
Embargo - When an article is flagged with an embargo, it lets users know that the article should not be published until a certain date and time. Note: The embargo does not actually prevent the article from being published before the flagged date.
Fetch - The process of moving an article to a shared desk. Usually specifically refers to moving an article from the Ingest to a Desk.
Flag: Flags are coloured article status markers that appear beneath the headline denoting the status of an article. Examples include; Legal, Not for Publication, Ingest, Published, Killed, Takes, etc.
Global Read - A toggled setting on a Desk stage or a Saved Search which allows it to be added to any Monitoring widget or Monitoring tab.
Global Search - A Search that encompasses all the articles in Superdesk, other than articles created in Custom Workspaces.
Grid / list icon - The grid icon is found on the Search tab and in the Legal archive. Clicking on it allows you to change between a list view and a thumbnail view. Thumbnail views are great for viewing images. Click on the list icon to switch back to the list view.
Highlights - Desk-specific curated lists of important articles. Highlight lists can be published or simply used for Superdesk internal communication.
Ingest - As a verb, it refers to the way in which articles from other news sources arrive or are imported into Superdesk. As a noun, the ingest refers to the list of articles that have arrived in Superdesk from external sources.
Ingest feed - A search containing only newly ingested articles and news items.
Ingest Source / Source - An Ingest Source is a feed from which Superdesk will bring in external news items.
Kill - The rescinding of an article that has already been published. Killing an article notifies all subscribers who received the article about this change, and it removes the article content from Superdesk.
Legal archive - A section in the settings menu which contains a list of all of the published items.
Macro - A specific set of rules and transformations that are applied to an article. Macros can be applied while editing an article.
Metadata - Metadata is information about items and articles in Superdesk. This information, which is attached to all items, includes fields like:
Slugline - a Superdesk-internal article description which appears adjacent to the headline.
Priority - a news value rating between 1 and 6. A value of 1 means it has the highest value.
Urgency - a rating between 1 and 6 on the relative significance of an article. 1 is highest.
Genre - a drop-down menu to select an article type, for example: interview, analysis, feature.
Place - a drop-down menu for where the article is being written.
Subject - a drop-down menu for selecting the topic, for example: politics, arts, sports, health.
The more complete your metadata is, the easier it will be to search for and update the item.
Monitoring - A tab in the Workspace Panel. Monitoring for shared desks is set up by the desk administrator. The Monitoring tab can be set up to show desk Stages and Saved Searches. The Monitoring tab in the Custom Workspace can be individually adjusted.
Monitoring Widget - A Dashboard widget which can be adjusted to show desk Stages and Saved Searches.
Multiedit - A feature in Superdesk which allows you to have more than one article open at the same time, side by side.
Output - Articles from a desk that are ready to be published.
Package - A number of items (articles and/or images) that users can group together. Packages can be published as a single item.
Personal Items - Articles or Items that have been created in a Custom Workspace.These articles are private until send to a shared desk. Personal Items will not show up in Global Searches.
Publish - The act of sending a completed item to your subscribers. News items can be published across multiple formats.
Publishing queue - A section in the settings menu which contains a list of published items and the publish destination (clients). If an article failed to publish successfully, you will see that recorded in the publish queue and you have the option to resend the item from the Publishing Queue tab.
Pyramid icon - The pyramid icon is found in the Monitoring view and in the Search tab beside the Sort drop-down menu. It allows you to reverse the order in which a list appears based on your Sort criteria. The reverse pyramid allows you to switch back to the previous view.
Related Items - A feature in the Editor Sidebar which allows users to search for items containing the same headline keywords.
Roles - A role is your designated job within Superdesk. Your role comes with a set of privileges and permissions. Some examples of roles are: journalist, editor, manager, reporter, bureau-chief, copytaker, producer, etc. Permissions for each role are customizable from the settings menu.
Saved Search - A Saved Search is a set of parameters which have been generated by a user in Superdesk to find articles. Saved Searches can be displayed in Monitoring Widgets and Monitoring tabs on shared desks if the Global Read toggle is set to the on position.
Settings Menu - Located in the top left corner of the Superdesk interface, the Settings menu is a black and white hamburger menu which allows users with the appropriate privileges to do things like configure the Superdesk workflow and view histories of published items.
Slugline - While articles are in production, it is common practice for journalists to designate them with a short name or slug. In the article editing window, users can enter this name in the slugline text box. Note that sluglines are Superdesk-internal and do not appear in the published version of an article.
Spike - Spiking removes articles from the desk workflow. Spiked articles aren’t deleted, but are moved to the Spiked Items section of that desk. You can’t spike items that are locked or currently open.
Stage - In Superdesk, content within shared desks are divided into Stages. Usually there’s an input area to which articles are fetched, an area for newly created items, an area for editing, an area for published items, etc. These areas are called Stages. Stage names (i.e. input, output, etc.) are defined by the desk administrator and can be unique to each shared desk.
Take - A take is a piece of a story, often written as the story unfolds. Selecting the New Take option creates a news item with the same headline, slugline and metadata but the body text is blank.Takes are numbered using the sequential takekey numbers as new takes are created. A take can be created from any text item, even after it has been published. Takes cannot be created for packages or media other than plain text.
Takekey - For articles that are broken up into more than one piece, the takekey number indicates the order in which they should be delivered. A higher number indicates a later part of the article. The takekey text box is also modified for articles that have been updated. For articles that aren’t broken up into takes, the takekey number is blank.
Username - Superdesk users log in using their username. Usernames are chosen at the time of profile creation. Comments directed towards a particular user can use @username to tag the user in a comment.
User icon - The user icon is a round icon found in the top-right corner of the Superdesk interface. Clicking a user icon enables the editing of your user profile and the option to log out of Superdesk. You can customize the image in your user icon by editing it in your profile. By default, your user icon is a blue circle containing your initials.
Widget - Widgets are tools that you can place on your Superdesk Dashboard. They allow for a quick overview of information and content. There are four different types of widgets available: Monitoring, Ingest, World Clock and Activity Stream. You can customize your personal Dashboard in your Custom Workspace. Shared desk Dashboards are usually configured with Widgets by the admin.
Workspace Panel - The Workspace Panel is the column of icons along the left side of the Superdesk interface. From top to bottom: Dashboard, Monitoring, Highlights, Tasks, Spike, Personal items,and Search.