IBM Support

Introduction to Collections

General Page

What is a collection?
  • A collection is a group of related resources that can include additional or multiple nested collections.

What does a collection look like on IBM Technology Zone?

collection overview

Collection overview 2

See on this collection that there are resources to help the end user get started with one of the following environments, like the setup guide for the VMWare Cloud adoption lab.

NOTE: Collections can be customized to look more complex than this one. For example, collections with journeys. Read the Introduction to Journeys runbook to see how owners/authors can drive a specific learning journey with their collections by ordering resources and environments into tabs that we call journeys.

  • A collection can encompass resources, environments, and journeys. It can be as complex or as simple as the owner/author deems fit to make the collection based on the experience they intend to drive to the consumer of their content.

  • A collections is not limited to pointing to other additional collections from one collection. Collections can be nested within a collection and managed similar to a resource on a collection.

Here is an example of multiple nested collections on this main collection: Cloud Pak for Business Automation Activiation Kit

NOTE: The box icon represents that this resource is of type collection. Hover over the box to see the type for yourself.

Collection nested example

How to create a collection

In this runbook we will walk through the required fields to submit a simple collection quickly on IBM Technology Zone!

  1. Select the 'Contribute your content' button right from the home page.

Share your content button

  1. Please read and agree to the "Content Contributor Guidelines" This will inform you of each content owner badge service level agreement that you must agree to before contributing to IBM Technology Zone.

content guideliens agreement modal

  1. Title of collection: Provide an intuitive title for this collection and see example displayed in the field.

collection title

  1. Custom URL field: This field will populate automatically based on the title of the collection you provided in the previous step. Feel free to change and create a custom URL as you deem fit as the content owner.

custom url field

Here is an example of a custom url on the site today:

  1. Short business value statement: Provide one sentence that showcases the value of this collection to the end user when searching for this content.

short business value statement

See two examples of how this field will display from the search page:

Example one: Grid view (Otherwise known as tile view)

Search example one

Example two: Table view (otherwise known as list view)

search example 2

  1. IBM Products field: Start typing in the product name that this collection is related to. A drop-down list will display once you are finished typing with results to choose from. Select the best product match from the list.

IBM Products field

  • In this example, I searched Cloud Pak for Data. Scroll through the results and choose the best match product based on the IBM product/solution that this collection intends to show the end user.

Product drop down list

  1. Brand field: This field is required but if you follow the previous step, this field will automatically populate based on the Product that you input in the IBM Product field.

auto populated taxonomy

  1. Visibility field: This field will allow you to select which users can view this collection.
  • Selecting IBMers, means that IBMers when logged in will be able to view this collection.
  • Selecting Business Partners, means that Business Partners when logged in will be able to view this collection.
  • Selecting IBMers & Business Partners, means this collection will be visible to both to view this collection.

Select the appropriate visibility level based on the intent for this collection.

visibility field

  1. Now, lets leave this collection in a status of draft and proceed to Save this collection as you have it!

Save the collection

  • Wait for the Collection saved notification to display before continuing.

Save collection notification

How to edit a collection

  1. Navigate to your collection from the *My library tab in the top navigation bar.

My library

  1. Select My created resources to view all collections that you have created to date.

My created resources

  1. Select the collection that you would like to edit.
  • Option 1: Click the collection tile itself to open the collection

Select collection

  • Option 2: Click the collection ellipsis and select View

collection ellipsis view

  1. From the view collection page, select the Edit button located in the top right of the collection banner.

Edit collection

Preview as you edit

Leverage the Preview option as you edit your collection to see how the changes will display on your collection once published.

  • Preview option at the top of the page. Preview option at the top of page

  • Preview option at the bottom of the page. preview option at the bottom of the page

[{"Type":"MASTER","Line of Business":{"code":"","label":""},"Business Unit":{"code":"","label":""},"Product":{"code":"SSNR6KN","label":"IBM Technology Zone"},"ARM Category":[{"code":"a8mKe0000004CVfIAM","label":"Content-\u003EPortal"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
19 February 2025

UID

ibm17159458