Once your content is created, it's important to ensure you're displaying your product help in a user-friendly way. Guide tabs provide a flexible way to display content within the current guide in various ways.
Guide Tab Types
We reviewed how to add in a tab in the previous article, but let's now understand what each tab does. Remember that you will need to add at least one:
|Name||What Does it Do?||Any Caveats?|
Displays an automatic of sorting of pages based on:
|Dependent on Site Activity|
|Classification||Displays articles which contain a specific classification.||
Only content which is classified will be displayed in MindTouch. When using the default MindTouch templates, content will be automatically classified.
|Article Directory||Displays list of all articles and sub-articles in alphabetical order.||N/A|
|Tag Directory||Displays list of articles grouped by tags.||Will display placeholders for drafted content to Pro Members only.|
|Topic Hierarchy||Displays list of guide content in hierarchical format.||
|Path||Displays any path or paths you choose.||Reminder- a Path can include articles that do not live within the direct guide it is located in.|
Guide Tab View
Depending on your site architecture, some guides may require only a single guide tab to display the articles within. In Page Settings, authors can select one of two Guide Listing Display options: Single or Tabbed view.
|Single View||Tabbed View|
View removes the tab UI from the page for a simpler presentation of the listed articles.
View displays the traditional tab UI.
Reordering the Tabs
Once you've added in your tabs, you can reorder these to fit your customer's needs. Simply drag a tab to move it around:
Changing Tab names
The default names of tabs are for Pro Members to understand the tab's technical purpose. Before taking your Guide live, consider renaming the tabs. To do so, click on the pencil icon in the tab:
Then type to rename, and click the "checkmark" icon to save:
Have any Tab name suggestions?
This is your product documentation so get creative, but here are some examples to run with:
- Topic Hierarchy: "Guide Contents"
- Classification: "[Name of Classification] Articles"
- Tag Directory: "Directory of Topics"
For a guide focused on getting started with your product, use the following tabs:
- Topic Hierarchy
- Classification (focused on specific article types)
- Tag Directory
For a guide focused on troubleshooting and FAQ content (typically referred to as a knowledge base), use the following tabs:
- Tag Directory
- Featured Articles
- Article Directory