documentation/dev-manual: Edits to clarify YP files

These edits help explain the differences between local YP files
created through a tarball extraction vs cloning a Git repository.

(From yocto-docs rev: ed368800c3e9ece71d27d6d690f0ddc264a4c2da)

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

1 files changed, 12 insertions, 2 deletions

diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index 95ef877856..2ff66a4b06 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -205,8 +205,8 @@
             by the maintainer of the source code.
             For example, in order for a developer to work on a particular piece of code, they need to 
             first get a copy of it from an "upstream" source.</para></listitem>
-        <listitem><para><emphasis>Yocto Project Files:</emphasis>
-            This term refers to the directory structure created as a result of downloading 
+        <listitem><para id='yocto-project-files'><emphasis>Yocto Project Files:</emphasis>
+            This term refers to the directory structure created as a result of either downloading 
             and unpacking a Yocto Project release tarball or setting up a Git repository
             by cloning <filename>git://git.yoctoproject.org/poky</filename>.
             Sometimes the term "the Yocto Project Files structure" is used as well.</para>
@@ -220,6 +220,16 @@
             results in a Yocto Project file structure whose Yocto Project source directory is named 
             <filename>poky-edison-6.0</filename>.
             If you create a Git repository, then you can name the repository anything you like.</para>
+            <para>It is important to understand the differences between Yocto Project Files created
+            by unpacking a release tarball as compared to cloning 
+            <filename>git://git.yoctoproject.org/poky</filename>.
+            When you unpack a tarball, you have an exact copy of the files based on the time of 
+            release - a fixed release point.
+            Any changes you make to your local Yocto Project files are on top of the release.
+            On the otherhand, when you clone the Yocto Project Git repository, you have an
+            active development repository.
+            In this case, any local changes you make to the Yocto Project can be later applied to active
+            development branches of the upstream Yocto Project Git repository.</para>
             <para>You can find instruction on how to set up the Yocto Project files on your 
             host development system by reading 
             the