Sometimes, topics share the same title but belong to different documents. These topics are grouped together as a single search result. A document selector provides a way to differentiate between different variants of the topic. It is necessary to open the document selector and select the document containing the desired variant of the topic.
Documents are not listed in a specific order in the document selector.
Example where only the document of origin makes the difference
The following example shows two variants of Introduction to Time Machines
:
Document title | Document of origin | Audience | Version |
---|---|---|---|
Introduction to Time Machines |
Time Machine User Guide |
Novice |
1.0 |
Introduction to Time Machines |
Time Machine Configuration Guide |
Novice |
1.0 |
Fluid Topics clusters both topics because they have the same value for the ft:clusterId
metadata. The title of the document of origin is the only way to distinguish between the two variants of the topic.
When uploaded to Fluid Topics, a document selector appears below the topic's title in the Search page to let users select the appropriate variant.
Example where other metadata keys are multivalued
The following example shows the Introduction to Time Machines
topic for which two variants exist and where each variant has its own metadata values.
Document title | Document of origin | Audience | Version |
---|---|---|---|
Introduction to Time Machines |
Time Machine User Guide |
Novice |
1.0 |
Introduction to Time Machines |
Time Machine Configuration Guide |
Expert |
2.0 |
When the document containing the topic is uploaded to Fluid Topics, the variants are still clustered the same way. However, when users select a document, the tags that shows the values for the Audience
and Version
metadata keys are updated accordingly. For example, when a user selects Time Machine User Guide
, the Novice
and 1.0
tags appear. When a user selects Time Machine Configuration Guide
, the Expert
and 2.0
tags appear.