diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
index a93ac50f6f..787dc7bff1 100644
--- a/documentation/bsp-guide/bsp.xml
+++ b/documentation/bsp-guide/bsp.xml
@@ -381,7 +381,8 @@
 
     <para>
         Below is an example of the Raspberry Pi BSP
-        layer that ships with the Yocto Project:
+        layer that is available from the
+        <ulink url='&YOCTO_GIT_URL;'>Source Respositories</ulink>:
         <literallayout class='monospaced'>
      meta-raspberrypi/COPYING.MIT
      meta-raspberrypi/README.md
@@ -882,18 +883,19 @@
         <para>
             You can find these files in the BSP Layer at:
             <literallayout class='monospaced'>
-     meta-<replaceable>bsp_name</replaceable>/recipes-kernel/linux/linux-yocto*.bbappend
+     meta-<replaceable>bsp_name</replaceable>/recipes-kernel/linux/linux*.bbappend
      meta-<replaceable>bsp_name</replaceable>/recipes-kernel/linux/*.bb
             </literallayout>
         </para>
 
         <para>
-            Append files (<filename>*.bbappend</filename> modify
+            Append files (<filename>*.bbappend</filename>) modify
             the main kernel recipe being used to build the image.
             The <filename>*.bb</filename> files would be a
-            developer-supplied recipe.
+            developer-supplied kernel recipe.
             This area of the BSP hierarchy can contain both these
-            types of files.
+            types of files, although in practice, it is likely that
+            you would have one or the other.
         </para>
 
         <para>
@@ -957,8 +959,8 @@
      linux-raspberrypi_4.14.bb
      linux-raspberrypi_4.9.bb
             </literallayout>
-            The directory contains three kernel recipes and an
-            include file.
+            The directory contains three kernel recipes and a
+            common include file.
         </para>
     </section>
 </section>
@@ -1063,7 +1065,7 @@
                             <itemizedlist>
                                 <listitem><para>
                                     Texas Instruments Beaglebone
-                                    (<filename>beaglebone-yocto</filename>
+                                    (<filename>beaglebone-yocto</filename>)
                                     </para></listitem>
                                 <listitem><para>
                                     Freescale MPC8315E-RDB