Skip to main content
MindTouch Success Center

Guided content framework

MindTouch sites consists of various templates (content containers) that serve distinct purposes. Use Article Type options to enable a structured and optimized content organization.

Article Type

  • Category - Highest level of content organization, for example, product lines or versions, languages, or personas.
  • Guide - Subsection of a category. It is the primary place for organizing content in a product line, for example.
  • Topic - Subcategory of a guide, similar to a chapter of a book, that deals with a more defined theme.
  • Reference - Explains associated functions/definitions that relate to a feature or topic.
  • How-to - Frequently contains step-by-step instructions that lead to a clear end goal or objective.

MindTouch content structure

Before you start structuring your content, it helps to have a clear vision of how you want to form your users' search experience. Always keep in mind, though, that no matter how you structure your site, MindTouch allows you to move content easily and without breaking any links or hierarchies. So there is nothing wrong with changing your mind. 

When you change your mind and switch content types, MindTouch does not convert the content type code. For example, if you change a category into a guide, the embedded code will still be the category code. You must copy the DekiScript code block from a guide (open a guide in Edit mode and copy the code block) into your newly converted content type to ensure it behaves as a guide.

Contact Support if you would like to have MindTouch handle this change automatically.

Common structure examples

► Category (e.g. language/persona/product suite/version)

► Guide

► Topic

► How-to

► Reference
 

You may add how-tos and references directly beneath guides. It is not required to add topics beneath a guide. But be aware that once your content grows, you likely will end up creating topics to organize your articles by subject and afford your users a more efficient search experience.

It is possible to nest multiple categories if, for example, you needed to organize your content by language or persona, then product suite, and then version.

► Category (language/persona)

► Category (product suite)

► Category (version)

► Guide

► Topic

► How-to

► Reference

Add multiple topics at the Guide level.

► Guide

► Topic

► Reference

► How-to

► Topic

► Reference

► How-to

  • Was this article helpful?