From 1b2d89737f51b85b475688f978678feafc13e341 Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <srifenbark@gmail.com>
Date: Wed, 28 Jun 2017 16:17:28 -0700
Subject: dev-manual: Added branch clarification to checking out poky

Re-wordings to be clear about what the user is getting when
they check out a development branch of an upstream repository.

(From yocto-docs rev: deb6ecfd35a76760bc2270bbbc69aa232b0c8cc7)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 documentation/dev-manual/dev-manual-start.xml | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

(limited to 'documentation')

diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml
index 1f617dc6a2..364a7631f2 100644
--- a/documentation/dev-manual/dev-manual-start.xml
+++ b/documentation/dev-manual/dev-manual-start.xml
@@ -611,9 +611,17 @@
             When you clone the upstream poky repository, you have access to
             all its development branches.
             Each development branch in a repository is unique as it forks
-            off the repositories "master" branch.
-            To see and use the files of any branch locally, you need to
-            know the branch name and then checkout the branch.
+            off the "master" branch.
+            To see and use the files of a particular development branch
+            locally, you need to know the branch name and then specifically
+            check out that development branch.
+            <note>
+                Checking out an active development branch by branch name
+                gives you a snapshot of that particular branch at the time
+                you check it out.
+                Further development on top of the branch that occurs after
+                check it out can occur.
+            </note>
             <orderedlist>
                 <listitem><para>
                     <emphasis>Switch to the Poky Directory:</emphasis>
@@ -648,7 +656,7 @@
                     </para></listitem>
                 <listitem><para>
                     <emphasis>Checkout the Branch:</emphasis>
-                    Checkout the branch in which you want to work.
+                    Checkout the development branch in which you want to work.
                     For example, to access the files for the Yocto Project
                     2.3 Release (Pyro), use the following command:
                     <literallayout class='monospaced'>
@@ -656,8 +664,8 @@
      Branch pyro set up to track remote branch pyro from origin.
      Switched to a new branch 'pyro'
                     </literallayout>
-                    The previous command checks out the "pyro" branch and
-                    reports that the branch is tracking the upstream
+                    The previous command checks out the "pyro" development
+                    branch and reports that the branch is tracking the upstream
                     "origin/pyro" branch.</para>
 
                     <para>The following command displays the branches
-- 
cgit v1.2.3-54-g00ecf