diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 24137480c1..85e6d778fb 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -583,7 +583,13 @@
         <glossentry id='var-KERNEL_FEATURES'><glossterm>KERNEL_FEATURES</glossterm>
             <glossdef>
                 <para>Includes additional metadata from the Linux Yocto kernel Git repository.
-                    The metadata includes config fragments and features descriptions,
+                    In the Yocto Project build system, the default Board Support Packages (BSPs)
+                    metadata is provided through 
+                    the <filename>KMACHINE</filename> and <filename>KBRANCH</filename> variables.
+                    You can use the <filename>KERNEL_FEATURES</filename> variable to further 
+                    add metadata for all BSPs.</para>
+                <para>The metadata you add through this variable includes config fragments and 
+                    features descriptions,
                     which usually include patches as well as config fragments.
                     You typically override the <filename>KERNEL_FEATURES</filename> variable
                     for a specific machine.</para>