Skip to main content
MindTouch Success Center

Tag pages (TCS)

This page applies to:MindTouch TCS

Overview

Tagging is used to assist MindTouch Pro Members with organizing content. Tags are used to link pages along common themes. Tags are also used as markers for the dynamic organization of content in MindTouch's Intelligent Documentation Framework (IDF). Here are some basic rules for managing tags on pages.

The Tags Section

 

The Tags section is near the bottom of every page located between the end of the main page content and the Comments section. There are two tag types: classifications and Custom tags. Here's how (and when) to use each.

Classifications

Classifications are a great way to dynamically organize content within IDF. Here, MindTouch users can select from a list of pre-defined tags which can be chosen from a drop-down menu to structure content to fit each organization's specific needs.

MindTouch has two classifications available: Article Type and Stage.

Article Type Tags

File:MindTouch_User_Guide/Content_Creation/Page_Management/Tagging/article_type.png

 

Article tags signal to the IDF what kind of article the page is. You can leave this tag blank or you can choose from any of the following pre-set tags:

  • Topic guide - reserved for Guide pages which are usually the parent pages of other article pages.
  • Feature - a page that describes a feature.
  • Methodology - a page that describes a working methodology.
  • Technology - a page that describes the inner workings of the product.
  • Beginner tutorial - a beginner level step-by-step guide to a complex interaction.
  • Intermediate tutorial - an intermediate level step-by-step guide to a complex interaction.
  • Advanced tutorial - an advanced level step-by-step guide to a complex interaction.
  • Troubleshooting - a brief process description to get users unstuck.
  • Feature reference - a dictionary-like description of a particular feature.
  • Sample reference - a snippet that shows how a feature can be used.

To tag a page with any of the above tags, just pull down the menu to the appropriate item. When it's set, you'll see the tag displayed just to the right of the pulldown menu. You can also select the "blank" item to remove this tag.

Stage Tags

File:MindTouch_User_Guide/Content_Creation/Page_Management/Tagging/stage.png

 

Stage tags are used in your own process workflow. You can leave this tag blank or you can choose from any of the following pre-set tags:

  • Stub - stubs are pages that are awaiting content. You use them to create placeholders for pages you will write content for (especially in outline mode).
  • Draft - a page which is currently being authored and not yet ready for review.
  • Review - a page ready for oversight or editing.
  • Final - a page that is ready for publication.
  • Outdated - a page that may no longer be suitable for publication and worthy of updating, review or making obsolete.
  • Obsolete - this page is no longer relevant due to signification drift from documentation and actual current product features.

To tag a page with any of the above tags, just pull down the menu to the appropriate item. When it's set, you'll see the tag displayed just to the right of the pulldown menu. You can also select the "blank" item to remove this tag.

 

Looking to customize your classifications? Be sure to take a look at our available add-on to add classifications.

Custom Tags

custom_tags.png

 

Custom tags are not classifications like Article and Stage tags. You can make Custom tags from any keyword. Once you've entered in a tag keyword (or phrase) of your choice, click enter and the tag will be saved to the page. It will appear as a link below the Custom tag entry field. If the tag already exists within the system, you will be presented with it as a dropdown below your manual entry.  

Once you have selected the tag it will appear as the following:

File:MindTouch_User_Guide/Content_Creation/Page_Management/Tagging/added_tag.png

  • Was this article helpful?