diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index 9f344a63cd..3abf3e73a8 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -584,6 +584,25 @@
the specification for .desktop files.
+
+ You can use the WARN_QA and
+ ERROR_QA variables to control the behavior of
+ these checks at the global level (i.e. in your custom distro
+ configuration).
+ However, to skip one or more checks in recipes, you should use
+ INSANE_SKIP.
+ For example, to skip the check for symbolic link
+ .so files in the main package of a recipe,
+ add the following to the recipe.
+ You need to realize that the package name override, in this example
+ ${PN}, must be used:
+
+ INSANE_SKIP_${PN} += "dev-so"
+
+ Please keep in mind that the QA checks exist in order to detect real
+ or potential problems in the packaged output.
+ So exercise caution when disabling these checks.
+