diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index a3f0c1b87a..3ed966f377 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -1530,6 +1530,28 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
             </glossdef>
         </glossentry>
 
+        <glossentry id='var-INSANE_SKIP'><glossterm>INSANE_SKIP</glossterm>
+            <glossdef>
+                <para>
+                    Specifies the QA checks to skip for a specific package 
+                    within a recipe.
+                    For example, to skip the check for symbolic link 
+                    <filename>.so</filename> files in the main package of a 
+                    recipe, add the following to the recipe.
+                    In this example, the package name override
+                    <filename>${PN}</filename> must be used:
+                    <literallayout class='monospaced'>
+     INSANE_SKIP_${PN} += "dev-so"
+                    </literallayout>
+                </para>
+                <para>
+                    See the "<link linkend='ref-classes-insane'>Generated Output Quality Assurance Checks - <filename>insane.bbclass</filename></link>"
+                    section for a list of the valid QA checks you can 
+                    specify using this variable.
+                </para>
+            </glossdef>
+        </glossentry>
+
 
     </glossdiv>