As you are moving down your architecture, your content levels will become more and more specific. Once you have built your last category level, it is time to add your next content level—the guide. If you broke your category levels out by products, for example, you now may decide to start building version guides to lead your users even closer to finding the right answers.
How to create a new guide
To create a new guide underneath a category, follow the steps below:
Step 1: Add a new guide
- Navigate to the category under which you want to create a guide.
- On your MindTouch toolbar, click New.
- Select the Guide template.
- Depending on whether you want to create the guide live or as a draft mode, select either the Create live or Create draft radio button. (You will be able to publish the draft to your live site later.)
- Click Create.
Do NOT create a guide underneath a guide. Only create guides underneath categories.
Step 2: Add content to your guide
- Title your guide.
- Replace text with your content.
Do not remove the DekiScript code boxes at the top of the page or the "Tags recommended by the template: article:topic-guide" line at the bottom of the page. Both determine how the guide page behaves.
Step 3: Configure the page settings of your guide
- Expand Page Settings.
- Hover over the Add page summary field to display the page summary icon .
- Click the icon and enter a page summary.
The page summary is not only the first paragraph that is displayed on your page, it also is the description that is displayed in MindTouch and Google search results, so make sure to include valuable keywords.
- Click Add page thumbnail to add the display icon for your guide.
- Make sure that Article type is set to Guide.
- If you have not yet set up any custom classifications, set a Stage value to help you later identify articles in certain stages of your workflow.
- Apply appropriate Tags to your article. (You must hit Enter after entering each tag.)
Tags determine the articles MindTouch recommends at the bottom of your page, so keep tags consistent. The more related tags articles have in common, the more likely they will be recommended together.
Step 4: Publish your guide (if a draft)
If you created your page in draft mode and are ready to publish your guide to your live site, click Publish.
You now have created your guide and are ready to add content that will really make your users happy. If you know you have a lot of individual articles, add topics to your guides next to provide that extra level of organization. But there is nothing wrong with adding how-tos or references directly to your guides if your articles can't be categorized easily underneath topics. To make the articles and topics you added to your guide show up in the guide tabs, read our article on how to display pages in the guide tabs.