Skip to main content
MindTouch Success Center

Create a checklist for high quality content

This page applies to:MindTouch (current)

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.  

Check

Criteria


Example / Notes
Unchecked checkbox

Minimum of 200 words 


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

Microcontent


The fewer headings, the better. Keep articles short and brief. Break out long pages into several pages.
Unchecked checkbox

A value statement


Why should the reader use? How will the user benefit?
Unchecked checkbox

Page summary


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

Tags (3 to 5)


Tag articles to ensure relevant recommended articles.
Unchecked checkbox

An instruction list

Step-by-step instruction (example):

  1. Navigate to Tools > Control panel.
  2. Click Site CSS.
Unchecked checkbox Search recommendations Search recommendations added to each article.
Unchecked checkbox

Hyperlinks (2 or more)


Learn how to add hyperlinks.
Unchecked checkbox

Images, screenshots, or diagrams (2 or more)


Include media, such as images or videos to enrich content. 
Unchecked checkbox

A title that appeals to a human with a job


Example:  Create beautiful articles for your developers
Unchecked checkbox
An article type assignment

Assign the appropriate article type in Page Settings > Article type.

Unchecked checkbox "What it looks like" image An image of what a visual element may look like when the customer properly follows directions.
Unchecked checkbox Author bar A visual indicator of who wrote the article. Learn how to create an author bar.
Unchecked checkbox Version indicator A visual indicator of the version the article applies to. Learn how to create a version indicator.
Unchecked checkbox

A code or HTML example 

<a href="http://help">This is how you add a hyperlink</a>
  • Was this article helpful?