Let's say you have hundreds of pages in your knowledge base (or you plan to). MindTouch can automatically organize them into a Knowledge base guide for you. This tutorial shows you how.
After completing this tutorial you will be able to create a single page that automatically organizes your knowledge base articles into a three sections: just the "featured" pages, all pages grouped by how they're tagged, and all pages listed alphabetically. The knowledge base guide, as we call it, also allows users to search just with the knowledge base for articles. All of this functionality is contained with one easy-to-create page called the Knowledge Base Guide. Setting one up should only take a minute. Here's how.
First Step - Navigate to Your Knowledge Base
Since May 10, 2011, every MindTouch.us site comes set up with a knowledge base section of the site already created. You can find it in the left nav of your site and it's titled "Knowledge Base". Or if you just want to navigate to it append "/kb" to the root URL of your site, like this: http://yoursite.mindtouch.us/kb.
Second Step - Creating a New Knowledge Base Article
What you will see there is an empty knowledge base waiting to be filled. The easiest way to create an article is to use the "New Knowledge Base Article" button located at the top of the page. When you have no content in your knowledge base, there will also be a button at the bottom of the page. But that one goes away once you have posted at least one article.
Alternative Step - Creating a New Knowledge Base Article (from any page)
Any page can be included in your knowledge base guide. It just has to fit two criteria.
- The article must be a page in the knowledge base section itself. In other words, it's a child page of the /kb section.
- The article must be tagged as: article:task-troubleshooting, article:task-tutorial or article:task-*.
That's really all you need to do to get a page to be included in your knowledge base guide page appropriately.
In addition to those two reserved tags, you should feel free to tag your pages with your own keywords. That way when a user selects the "View by Tags" page, pages are grouped by tags instead and can in some cases be easier to find.
The power of the knowledge base is in how you tag your pages. Tagging serves two purposes. First, it helps link several articles together. Second, it is the means by which Intelligent Document Framework (IDF) and the knowledge base guide page finds, organizes and displays what articles and topics are included in your knowledge base. Spend a few minutes learning more about MindTouch IDF and tagging.