From 39e61c9ad9622d805a64413201b308e6a09943d1 Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <srifenbark@gmail.com>
Date: Thu, 29 Jun 2017 13:31:00 -0700
Subject: kernel-dev: Inserted section on Git as a relavent note

Appendix A of the kernel-dev had a subsection dedicated to just
saying Git was the SCM used by the YP team for development.  Having
this information in a dedicated section was overkill.  The information
is better as an "aside".  I put the stuff in a note.

(From yocto-docs rev: 7e28686f946188daaf0480d4cd68e0e8ff854d37)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 .../kernel-dev/kernel-dev-concepts-appx.xml        | 59 ++++++++++++----------
 1 file changed, 31 insertions(+), 28 deletions(-)

(limited to 'documentation')

diff --git a/documentation/kernel-dev/kernel-dev-concepts-appx.xml b/documentation/kernel-dev/kernel-dev-concepts-appx.xml
index ee40938b5d..21f7c2c686 100644
--- a/documentation/kernel-dev/kernel-dev-concepts-appx.xml
+++ b/documentation/kernel-dev/kernel-dev-concepts-appx.xml
@@ -200,10 +200,37 @@
                 on top of the baseline.
                 The features are tagged and organized by way of a branching
                 strategy implemented by the Yocto Project team using the
-                source code manager (SCM) Git.
-                For information on Git as applied to the Yocto Project, see the
-                "<ulink url='&YOCTO_DOCS_REF_URL;#git'>Git</ulink>" section
-                in the Yocto Project Development Manual.
+                Source Code Manager (SCM) Git.
+                <note><title>Notes</title>
+                    <itemizedlist>
+                        <listitem><para>
+                            Git is the obvious SCM for meeting the Yocto Linux
+                            kernel organizational and structural goals
+                            described in this section.
+                            Not only is Git the SCM for Linux kernel
+                            development in <filename>kernel.org</filename> but,
+                            Git continues to grow in popularity and supports
+                            many different work flows, front-ends and
+                            management techniques.
+                            </para></listitem>
+                        <listitem><para>
+                            You can find documentation on Git at
+                            <ulink url='http://git-scm.com/documentation'></ulink>.
+                            You can also get an introduction to Git as it
+                            applies to the Yocto Project in the
+                            "<ulink url='&YOCTO_DOCS_REF_URL;#git'>Git</ulink>"
+                            section in the Yocto Project Reference Manual.
+                            The latter reference provides an overview of
+                            Git and presents a minimal set of Git commands
+                            that allows you to be functional using Git.
+                            You can use as much, or as little, of what Git
+                            has to offer to accomplish what you need for your
+                            project.
+                            You do not have to be a "Git Expert" in order to
+                            use it with the Yocto Project.
+                            </para></listitem>
+                    </itemizedlist>
+                </note>
             </para>
 
             <para>
@@ -342,30 +369,6 @@
                 because the kernel tree is left in this state after cloning and building the kernel.
             </para>
         </section>
-
-        <section id='source-code-manager-git'>
-            <title>Source Code Manager - Git</title>
-            <para>
-                The Source Code Manager (SCM) is Git.
-                This SCM is the obvious mechanism for meeting the previously mentioned goals.
-                Not only is it the SCM for <filename>kernel.org</filename> but,
-                Git continues to grow in popularity and supports many different work flows,
-                front-ends and management techniques.
-            </para>
-            <para>
-                You can find documentation on Git at <ulink url='http://git-scm.com/documentation'></ulink>.
-                You can also get an introduction to Git as it applies to the Yocto Project in the
-                "<ulink url='&YOCTO_DOCS_REF_URL;#git'>Git</ulink>"
-                section in the Yocto Project Reference Manual.
-                These referenced sections overview Git and describe a minimal set of
-                commands that allows you to be functional using Git.
-                <note>
-                    You can use as much, or as little, of what Git has to offer to accomplish what
-                    you need for your project.
-                    You do not have to be a "Git Master" in order to use it with the Yocto Project.
-                </note>
-            </para>
-        </section>
     </section>
 </appendix>
 <!--
-- 
cgit v1.2.3-54-g00ecf