Skip to main content
MindTouch Success Center

Content quality checklist

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.  



Example / Notes

Minimum of 200 words 

Word count is provided in the MindTouch editor underneath the Styles button.


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?

Page summary

Two to three sentences describing the article and benefit. Summaries show in search results and recommended articles. 

Tags (3 to 5)

Tag articles to ensure relevant recommended articles.

An instruction list

Step-by-step instruction (example):

  1. Navigate to Tools > Control panel.
  2. Click Site CSS.
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>
  • Was this article helpful?