yocto-project-qs: Updated "Welcome" section.

I moved the bit about using a VM if you don't have a Linux
machine to a note as it broke the natural flow of this section.
Also, inserted a link to the comprehensive list of links and
other documentation references to the existing list of
other information.

(From yocto-docs rev: 73750063580ef7bc20bd445adc3e2b0b01e2257f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 24 insertions, 15 deletions

diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index 51da525fa4..197ddd53cb 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -69,18 +69,6 @@
         </para>
 
         <para>
-            If you do not have a system that runs Linux and you want to give
-            the Yocto Project a test run, you might consider using the Yocto
-            Project Build Appliance.
-            The Build Appliance allows you to build and boot a custom embedded
-            Linux image with the Yocto Project using a non-Linux development
-            system.
-            See the
-            <ulink url='https://www.yoctoproject.org/tools-resources/projects/build-appliance'>Yocto Project Build Appliance</ulink>
-            for more information.
-        </para>
-
-        <para>
             This quick start is written so that you can quickly get a
             build host set up to use the Yocto Project and then build some
             Linux images.
@@ -96,20 +84,33 @@
             hardware.
             The examples highlight the ease with which you can use the
             Yocto Project to create images for multiple types of hardware.
+            <note>
+                If you do not have a system that runs Linux and you want to give
+                the Yocto Project a test run, you might consider using the Yocto
+                Project Build Appliance.
+                The Build Appliance allows you to build and boot a custom embedded
+                Linux image with the Yocto Project using a non-Linux development
+                system.
+                See the
+                <ulink url='https://www.yoctoproject.org/tools-resources/projects/build-appliance'>Yocto Project Build Appliance</ulink>
+                for more information.
+            </note>
         </para>
 
         <para>
             For more detailed information on the Yocto Project, you can
             reference these resources:
             <itemizedlist>
-                <listitem><para><emphasis>Website:</emphasis>
+                <listitem><para>
+                    <emphasis>Website:</emphasis>
                     The
                     <ulink url='&YOCTO_HOME_URL;'>Yocto Project Website</ulink>
                     provides the latest builds, breaking news, full development
                     documentation, and access to a rich Yocto Project
                     Development Community into which you can tap.
                     </para></listitem>
-                <listitem><para><emphasis>FAQs:</emphasis>
+                <listitem><para>
+                    <emphasis>FAQs:</emphasis>
                     Lists commonly asked Yocto Project questions and answers.
                     You can find two FAQs:
                     <ulink url='&YOCTO_WIKI_URL;/wiki/FAQ'>Yocto Project FAQ</ulink>
@@ -117,7 +118,8 @@
                     "<ulink url='&YOCTO_DOCS_REF_URL;#faq'>FAQ</ulink>"
                     chapter in the Yocto Project Reference Manual.
                     </para></listitem>
-                <listitem><para><emphasis>Developer Screencast:</emphasis>
+                <listitem><para>
+                    <emphasis>Developer Screencast:</emphasis>
                     The
                     <ulink url='http://vimeo.com/36450321'>Getting Started with the Yocto Project - New Developer Screencast Tutorial</ulink>
                     provides a 30-minute video created for users unfamiliar
@@ -126,6 +128,13 @@
                     While this screencast is somewhat dated, the introductory
                     and fundamental concepts are useful for the beginner.
                     </para></listitem>
+                <listitem><para>
+                    <emphasis>Comprehensive List of Links and Other Documentation:</emphasis>
+                    The
+                    "<ulink url='&YOCTO_DOCS_REF_URL;#resources-links-and-related-documentation'>Links and Related Documentation</ulink>"
+                    section in the Yocto Project Reference Manual provides a
+                    comprehensive list of related links and documentation.
+                    </para></listitem>
             </itemizedlist>
         </para>
     </section>