diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 85e6d778fb..6843094fca 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -590,9 +590,11 @@
add metadata for all BSPs.
The metadata you add through this variable includes config fragments and
features descriptions,
- which usually include patches as well as config fragments.
+ which usually includes patches as well as config fragments.
You typically override the KERNEL_FEATURES variable
- for a specific machine.
+ for a specific machine.
+ In this way, you can provide validated, but optional, sets of kernel
+ configurations and features.
For example, the following adds netfilter to all
the Linux Yocto kernels and adds sound support to the qemux86
machine: