documentation/dev-manual/dev-manual-newbie.xml: updated intro paragraph and figs

I updated the introduction paragraph to cast the chapter more for YP than
just generic newbie information.  Also, added three screenshots for
the source areas at Dave Stewart's suggestion.

(From yocto-docs rev: 26d3c58ff6295515c593c8b0b12dc3d6952b752a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 20 insertions, 15 deletions

diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index 6654e7153e..a1652018df 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -3,21 +3,18 @@
 
 <chapter id='dev-manual-newbie'>
 
-<title>Working with Open Source Code</title>
+<title>The Yocto Project Open Source Development Environment</title>
 
 <para>
-    This chapter presents information for users new or unfamiliar with working in an open source environment.  
-    Working in this type of environment is different than working in a closed, proprietary environment.  
-    The chapter also presents information specific to the Yocto Project environment.  
-    It specifically addresses licensing issues, code repositories, the open-source distributed version control 
-    system Git, and best practices using Yocto Project.
+    This chapter helps you understand the Yocto Project as an open source development project.
+    In general, working in an open-source environment is very different than working in a closed, 
+    proprietary environment.  
+    Additionally, the Yocto Project uses specific tools and constructs as part of its development 
+    environment.  
+    The chapter specifically addresses open source philosophy, licensing issues, code repositories, 
+    the open source distributed version control system Git, and best practices using Yocto Project.
 </para>
 
-<note><para>
-    If you are a seasoned open source developer and are familiar with Git, you might just be interested 
-    in the Yocto Project specific information in this chapter.
-</para></note>
-
 <section id='open-source-philosophy'>
     <title>Open Source Philosophy</title>
 
@@ -102,18 +99,26 @@
             <listitem><para><emphasis><ulink url='http://git.yoctoproject.org/cgit/cgit.cgi'>Source Repositories:</ulink></emphasis>
                 This area contains IDE Plugins, Matchbox, Poky, Poky Support, Tools, Yocto Linux Kernel, and Yocto 
                 Metadata Layers.
-                You can create Git repositories for each of these areas.</para></listitem>
+                You can create Git repositories for each of these areas.</para>
+                <para>
+                <imagedata fileref="figures/source-repos.png" align="center" width="6in" depth="4in" />
+                </para></listitem>
             <listitem><para><emphasis><ulink url='http://autobuilder.yoctoproject.org/downloads/'>Index of /downloads:</ulink></emphasis>
                 This area contains an index of the Eclipse-plugin, miscellaneous support, poky, pseudo, and 
                 all released versions of Yocto Project in the form of images or tarballs.
                 Downloading and extracting these files does not produce a Git repository but rather 
                 a snapshot of a particular release or image. 
-                [WRITER NOTE: link will be http://downloads.yoctoproject.org.]</para></listitem>
+                [WRITER NOTE: link will be http://downloads.yoctoproject.org.]</para>
+                <para>
+                <imagedata fileref="figures/index-downloads.png" align="center" width="6in" depth="4in" />
+                </para></listitem>
             <listitem><para><emphasis><ulink url='http://www.yoctoproject.org/download'>Yocto Project Download Page</ulink></emphasis>
                 This page on the Yocto Project website allows you to download any Yocto Project
-                release of Board Support Package (BSP) in tarball form.
+                release or Board Support Package (BSP) in tarball form.
                 The tarballs are similar to those found in the 
-                <ulink url='http://autobuilder.yoctoproject.org/downloads/'>Index of /downloads:</ulink> area.
+                <ulink url='http://autobuilder.yoctoproject.org/downloads/'>Index of /downloads:</ulink> area.</para>
+                <para>
+                <imagedata fileref="figures/yp-download.png" align="center" width="6in" depth="4in" />
             </para></listitem>
         </itemizedlist>
     </para>