1 files changed, 8 insertions, 3 deletions

diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml
index 6ab93f79cf..b79f65e878 100644
--- a/documentation/dev-manual/dev-manual-start.xml
+++ b/documentation/dev-manual/dev-manual-start.xml
@@ -89,7 +89,9 @@
                 <link linkend='git'>Git</link> to clone a local copy
                 of the upstream <filename>poky</filename> repository,
                 or by downloading and unpacking a tarball of an official
-                Yocto Project release.</para>
+                Yocto Project release.
+                The preferred method is to create a clone of the repository.
+                </para>
                 <para>Working from a copy of the upstream repository allows you
                 to contribute back into the Yocto Project or simply work with
                 the latest software on a development branch.
@@ -199,9 +201,9 @@
                 <para>The Yocto Project uses the following BSP layer naming
                 scheme:
                 <literallayout class='monospaced'>
-     meta-&lt;BSP_name&gt;
+     meta-<replaceable>bsp_name</replaceable>
                 </literallayout>
-                where <filename>&lt;BSP_name&gt;</filename> is the recognized
+                where <replaceable>bsp_name</replaceable> is the recognized
                 BSP name.
                 Here are some examples:
                 <literallayout class='monospaced'>
@@ -350,6 +352,9 @@
         You can find details on all these steps in the
         "<ulink url='&YOCTO_DOCS_QS_URL;#using-pre-built'>Using Pre-Built Binaries and QEMU</ulink>"
         section of the Yocto Project Quick Start.
+        You can learn more about using QEMU with the Yocto Project in the
+        "<link linkend='dev-manual-qemu'>Using the Quick EMUlator (QEMU)</link>"
+        section.
     </para>
 
     <para>