diff --git a/documentation/dev-manual/dev-manual-intro.xml b/documentation/dev-manual/dev-manual-intro.xml
index 01aafc45b5..9d20fd3687 100644
--- a/documentation/dev-manual/dev-manual-intro.xml
+++ b/documentation/dev-manual/dev-manual-intro.xml
@@ -10,16 +10,27 @@
 
         <para>
             Welcome to the Yocto Project Development Manual!
-            This manual gives you an idea of how to use the Yocto Project to develop embedded Linux
-            images and user-space applications to run on targeted devices.
-            Reading this manual gives you an overview of image, kernel, and user-space application development
-            using the Yocto Project.
-            Because much of the information in this manual is general, it contains many references to other
-            sources where you can find more detail.
-            For example, detailed information on Git, repositories and open source in general
-            can be found in many places.
-            Another example is how to get set up to use the Yocto Project, which our Yocto Project
-            Quick Start covers.
+            This manual gives you an idea of how to use the Yocto Project to
+            develop embedded Linux images and user-space applications to run on
+            targeted devices.
+            Reading this manual gives you an overview of image, kernel, and
+            user-space application development using the Yocto Project.
+            Because much of the information in this manual is general, it
+            contains many references to other sources where you can find more
+            detail.
+            For example, detailed information on Git, repositories and open
+            source in general can be found in many places.
+            Another example is how to get set up to use the Yocto Project,
+            which our Yocto Project Quick Start covers.
+            <note>
+                By default, using the Yocto Project creates a Poky distribution.
+                However, you can create your own distribution by providing key
+                <link linkend='metadata'>Metadata</link>.
+                A good example is Angstrom, which has had a distribution
+                based on the Yocto Project since its inception.
+                See the "<link linkend='creating-your-own-distribution'>Creating Your Own Distribution</link>"
+                section for more information.
+            </note>
         </para>
 
         <para>
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml
index b9401e9017..c4d91fff84 100644
--- a/documentation/dev-manual/dev-manual-start.xml
+++ b/documentation/dev-manual/dev-manual-start.xml
@@ -33,8 +33,15 @@
     <para>
         You can use the OpenEmbedded build system, which uses
         BitBake to develop complete Linux
-        images and associated user-space applications for architectures based on ARM, MIPS, PowerPC,
-        x86 and x86-64.
+        images and associated user-space applications for architectures based
+        on ARM, MIPS, PowerPC, x86 and x86-64.
+        <note>
+            By default, using the Yocto Project creates a Poky distribution.
+            However, you can create your own distribution by providing key
+            <link linkend='metadata'>Metadata</link>.
+            See the "<link linkend='creating-your-own-distribution'>Creating Your Own Distribution</link>"
+            section for more information.
+        </note>
         While the Yocto Project does not provide a strict testing framework,
         it does provide or generate for you artifacts that let you perform target-level and
         emulated testing and debugging.