Tagging provides another level of categorization in MindTouch. A combination of hierarchy and tagging makes it possible to provide multiple layers of segmentation around your content.
The Tags section is located to the right of each article below the Last Modified date. There are two different ways to tag a page.
- Custom Tags: Create custom tagging by entering tags in the Add new tag here field.
- Classification Drop-down: Predefined set of tags that the user can choose from (ex: Article Type and Stage).
NOTE: Custom tags and classification drop-downs will not affect page restrictions for any users. If you change the article type, stage, or add a custom tag there will be no impact on permissions for any users.
Custom Tags can be added to any article to provide additional meta data on the article along with contributing to the HelpRank for the article. Custom tags are also used to drive the Related Articles section within MindTouch 4.
Add a custom tag
You need to at least be an author to add or change tags. To add a custom tag:
- Click the text field under Tags that says Add new tag here.
- Type out the tag that you want to add.
Note: If the tag exists in MindTouch already, it will recommend it to you:
3. Once you have the correct tag hit Enter and it will add it to a list below the text area:
Remove a custom tag
If you'd like to remove a tag, click the x to the left of the tag and it will be removed from the article.
Classification drop-down lists
Classification drop-down lists allow you to have a predefined set of options that an author, or higher, can select and apply to the article. MindTouch includes two classification drop-down lists out of the box that help facilitate staging of content along with categorizing content so that it surfaces properly in MindTouch.
Article Type tags
Article tags signal to Mindtouch 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:
- Category: use for first-level pages that represent a product or persona, which houses user guides and knowledge bases.
- Guide: use for the parent pages of other article pages.
- Topic: use for pages that discuss information about a specific topic.
- How-to: use for pages that provide a step-by-step process to complete an action.
- Reference: use for pages that provide general or detailed information about a specific feature of a product.
To tag a page with any of the above tags, just pull down the menu to the appropriate item. When it is set, you will see the tag displayed in the drop-down menu. You can also select (not set) to remove an article tag.
Stage tags are used to help staging content. You may leave this tag blank or you may choose from any of the following pre-set tags:
- Stub: stubs are pages that are awaiting content. Use them to create placeholders for pages you will write content for later.
- 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: a page that 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 is set, you will see the tag displayed just to the right of the pull-down menu. You can also select the (not set) to remove a stage tag.
Tags play an important part in the information architecture of your content. Before you start adding tags, make sure you have mapped out how you want your content organized because it will ensure that you do not have unnecessary tags.