1 files changed, 25 insertions, 2 deletions

diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
index 696e4ee7e2..a39a611b38 100644
--- a/documentation/bsp-guide/bsp.xml
+++ b/documentation/bsp-guide/bsp.xml
@@ -220,7 +220,7 @@
             <section id="bsp-filelayout-readme">
             <title>README File</title>
             <para>
-                You can find these files in the BSP Layer at:
+                You can find this file in the BSP Layer at:
                 <literallayout class='monospaced'>
      meta-&lt;bsp_name&gt;/README
                 </literallayout>
@@ -234,7 +234,30 @@
             </para>
 
             <para>
-                Technically speaking a <filename>README</filename> is optional but it is highly 
+                Technically speaking a <filename>README</filename> file is optional but it is highly 
+                recommended that every BSP has one.
+            </para>
+            </section>
+
+            <section id="bsp-filelayout-readme-sources">
+            <title>README.sources File</title>
+            <para>
+                You can find this file in the BSP Layer at:
+                <literallayout class='monospaced'>
+     meta-&lt;bsp_name&gt;/README.sources
+                </literallayout>
+            </para>
+
+            <para>
+                This file provides information on where to locate the BSP source files.
+                For example, information provides where to find the sources that comprise
+                the images shipped with the BSP.
+                Information is also included to help you find the metadata used to generate the images
+                that ship with the BSP.
+            </para>
+
+            <para>
+                Technically speaking a <filename>README.sources</filename> file is optional but it is highly 
                 recommended that every BSP has one.
             </para>
             </section>