1 files changed, 7 insertions, 2 deletions

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index c7f1122fd4..9c97ac1fb2 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -6081,7 +6081,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>,
                     is "cpio.gz".
                     The Linux kernel's initramfs mechanism, as opposed to the
-                    initrd mechanism, expects an optionally compressed cpio
+                    initial RAM disk
+                    <ulink url='https://en.wikipedia.org/wiki/Initrd'>initrd</ulink>
+                    mechanism, expects an optionally compressed cpio
                     archive.
                 </para>
             </glossdef>
@@ -6105,7 +6107,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     filesystem recipe (e.g.
                     <filename>core-image-sato</filename>).
                     See the <filename>core-image-sato-initramfs.bb</filename>
-                    recipe, which is created, for an example recipe.
+                    recipe for an example initramfs recipe.
+                    To select this recipe to provide the initramfs,
+                    set <filename>INITRAMFS_IMAGE</filename> to
+                    "core-image-sato-initramfs".
                     <note>
                         The initramfs image recipe should set
                         <link linkend='var-IMAGE_FSTYPES'><filename>IMAGE_FSTYPES</filename></link>