Learn how rulesets work and how to customize them using the rule editor.
Scroll Content Quality enables you to create custom rules for maintaining content quality standards across different use cases. For each activated space, a customizable set of rules is defined. This article will give you an overview of how these rulesets work and how you can customize them using the rule editor.
In an activated space, select Scroll Content Quality in your sidebar and click Configure rule, and that will open the rule editor.
The rule editor dialog is a text editor that uses the YAML syntax. After activating Scroll Content Quality in a space for the first time, this editor will display the preset rules. Delete, rewrite, or add new ones to create your own custom set of rules.
New to YAML?
We recommend reading this article before getting started, see YAML Tutorial: Everything You Need to Get Started in Minutes.
For each rule, five settings should be configured:
1: Rule type
Specifies the core function of your rule. Each rule type has a unique name that cannot be changed. You can create multiple rules of the same rule type in a single rule set. At the moment, Scroll Content Quality supports these rule types:
Check links to external websites.
Check that images have an alternative text description.
Confirm that no legacy Scroll Macros are used.
Control which macros can be used by either allow- or block-listing macros.
Check for specific words and recommend an alternative that should be used instead.
Check for capitalization in various contexts (in headings, for example).
Defines the overall intention of the rule in a few words.
The rule description is used as the title for each problem in your page report. Try to be as concise and clear as possible so your teammates are able understand the problem at first glance.
This setting marks the level of severity and how quality issues of this rule should be handled. There are three levels that can be set for each rule:
🔴 Critical: Critical or technical quality issue. Fix is required.
🟠 Major: Quality issue will most likely alter the page's content quality. Fix is highly recommended.
🔵 Minor: Quality issue depends on the use case. Fix is optional.
4: Ignore label
Each rule type has its own unique ignore label. Use these labels to ignore rules on a page.
5: Config options
The configuration options depend on the rule type. Some types you can only turn on and off, while others can be scoped and configured for multiple use cases. Learn how to configure each rule type along with some examples and tips in the upcoming rule type articles.
Click Save to apply the new set of rules to your space. Be aware that each page needs to be checked again after doing so.