Your MindTouch site consists of various templates that serve a distinct purpose. The MindTouch guided content framework uses different content types to ensure the stability of your site structure and create a logical organization of your content.
MindTouch content types
|Category||The highest level of content under the framework. Examples of typical categories include product lines or versions, specific 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 firstname.lastname@example.org if you would like to have MindTouch handle this change automatically.
As you are building out your content, use the following hierarchy structure to ensure that the unique capabilities of the MindTouch content framework is properly leveraged:
► Category (e.g. language/persona/product suite/version)
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)
Add multiple topics
To add multiple topics, simply go up to the guide page and add a new topic, as below: