This article provides criteria for assessing the quality of your MindTouch content. You should use these criteria as a basic framework to start measuring and understanding your content quality. Over time, your criteria should evolve while adapting to the requirements of your industry and business.
It is important to note that a high-quality article is expected to meet roughly 80% of the criteria that you put in place. To learn more about measuring the quality of your MindTouch content, please refer to our best practices on managing quality content.
Why should I create quality criteria?
Essentially, you want to create quality criteria to ensure that your content is consistent through accessible and facilitating learning. The criteria we have created below aim at ensuring your content is thorough, is optimized for Google, and encourages learning. Creating quality criteria and regularly measuring the quality of your content provides you with important metrics to highlight the evolution of your content and authorship over time.
Basic criteria example
At MindTouch, high-quality content will meet 80% of the below requirements. Defining quality criteria that is too rigid can complicate your content. For instance, it may not make sense to have a code example if you also have a video.
- Minimum of 200 words: Word count is provided in the MindTouch editor underneath the Styles button.
- Microcontent: The fewer headings, the better. Keep articles short and brief. Break out long pages into several pages.
- A value statement: Why should the reader use? How will the user benefit?
- Tags (3 to 5): Tag articles to ensure relevant recommended articles.
- Search recommendations: Search recommendations added to each article.
- Hyperlinks (2 or more): Learn how to add hyperlinks.
- Images, screenshots, or diagrams (2 or more): Include media, such as images or videos to enrich content.
- A title that appeals to a human with a job: Example - Create beautiful articles for your developers
- An article type assignment: Assign the appropriate article type in Page Settings > Article type.
- "What it looks like" image: An image of what a visual element may look like when the customer properly follows directions
- Author bar: A visual indicator of who wrote the article. Learn how to create an author bar.
- Version indicator: A visual indicator of the version the article applies to. Learn how to create a version indicator.
- A code or HTML example:
<a href="http://help">This is how you add a hyperlink</a>