diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
index c3a6fac9ea..355c716ff9 100644
--- a/documentation/bsp-guide/bsp.xml
+++ b/documentation/bsp-guide/bsp.xml
@@ -690,13 +690,13 @@
             files for the BSP.
             Most notably would be the formfactor files.
             For example, in the Raspberry Pi BSP there is the
-            <filename>formfactor_0.0.bbappend</filename> file,
+            <filename>formfactor_%.bbappend</filename> file,
             which is an append file used to augment the recipe
             that starts the build.
             Furthermore, there are machine-specific settings used
             during the build that are defined by the
             <filename>machconfig</filename> file further down in
-            the directory.
+            the directory (i.e. <filename>formfactor/rpi/).
             Here is the <filename>machconfig</filename> file for
             the Raspberry Pi BSP:
             <literallayout class='monospaced'>
@@ -716,7 +716,8 @@
             formfactor recipe
             <filename>meta/recipes-bsp/formfactor/formfactor_0.0.bb</filename>,
             which is found in the
-            <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>.
+            <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>
+            (i.e. <filename>poky</filename>).
         </para></note>
     </section>