diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 258b13efde..ccb48e438b 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -954,10 +954,10 @@ Core layer for images cannot be removed
                     Although you can use this variable from within a recipe,
                     best practices dictate that you do not.
                     <note>
-                        Use the
+                        To enable primary features from within the image, use
+                        the
                         <link linkend='var-IMAGE_FEATURES'><filename>IMAGE_FEATURES</filename></link>
-                        variable from within a recipe to define the primary
-                        list of features you want to add to the image.
+                        variable.
                     </note>
                 </para>
 
@@ -1243,7 +1243,8 @@ Core layer for images cannot be removed
                     <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>,
                     best practices dictate that you do not.
                     <note>
-                        Add extra features to the image by using the
+                        To enable extra features from outside the image,
+                        use the
                         <filename><link linkend='var-EXTRA_IMAGE_FEATURES'>EXTRA_IMAGE_FEATURES</link></filename> variable.
                     </note>
                     For a list of image features that ships with the Yocto