Glossary

Glossary items are terms specific to a particular domain. They are uncommon terms that are referenced to provide additional information for a specific topic.

For example, a glossary term for "Heartbleed", the security bug disclosed in April 2014, is illustrated as follows:

glossary example.png

Glossary details

  • Term: The term keyword that appear in the Glossary and Tasks.

  • Summary: A short excerpt that will appear in the tooltips and listings.

    • This field uses Markdown for rich text formatting.

  • Text: A full description that is shown in the term’s detail page.

    • This field uses Markdown for rich text formatting.

Create a Glossary Term

Create a Glossary Term by following the steps below.

Prerequisites:

  • The user has the permission Global Roles→Customization→Customize content.

Steps:

  1. Open the Library→Glossary page.

  2. Click Add Term.

  3. Fill in the required fields.

  4. Click Save.

The new Glossary Term can be used in content. See Use a Glossary Term in content for more details.

Edit a Glossary Term

Edit a Glossary Term by following the steps below.

Prerequisites:

  • The user has the permission Global Roles→Customization→Customize content.

Steps:

  1. Open the Library→Glossary page.

  2. Search for the glossary item and select the dropdown menu item.

  3. Click Edit Term.

  4. Update the required fields.

  5. Click Save.

The Glossary Term is updated immediately in all references.

Delete a Glossary Term

Delete a Glossary Term by following the steps below.

Prerequisites:

  • The user has the permission Global Roles→Customization→Customize content.

Steps:

  1. Open the Library→Glossary page.

  2. Search for the glossary item and select the dropdown menu item.

  3. Click Edit Term.

  4. Click Delete Term and acknowledge the warning.

  5. Click Confirm.

The Glossary Term is removed from the system and any content references to it are left untouched. Users who follow any links to the glossary are taken to a "Page Not Found" page.

Use a Glossary Term in content

Use an existing Glossary Term in content by following the steps below.

Prerequisites:

  • The user has the permission Global Roles→Customization→Customize content.

Steps:

  1. Open the Library→Glossary page.

  2. Search for the glossary item and select the [content copy] icon to copy its Markdown link to your system clipboard.

  3. Open the Task, Problem, How-To, or Additional Requirement for editing.

  4. Identify a content field that supports Markdown formatting.

  5. Paste the contents of the clipboard to the desired location.

  6. Save the content.

The content is updated with a reference to the glossary item.

View a Glossary Term in read-only mode

Examine a read-only version of a Glossary Term by following the steps below.

Prerequisites:

  • The user has the permission Global Roles→User Management→Modify own user settings.

  • The user does not have the permission Global Roles→Customization→Customize content.

Steps:

  1. Open the Library→Glossary page.

  2. Click on the magnifying glass [search] icon on the left side of the page.

  3. Search for specific terms by name.

  4. Open the desired glossary term by selecting its title.

Glossary Terms matching the filter are displayed in the list view. A term you select is presented in full detail, but you cannot modify it in this view.

results matching ""

    No results matching ""