From 5865fcdf856f003cddabf476acb4e4f953db96e9 Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <srifenbark@gmail.com>
Date: Fri, 18 Aug 2017 15:27:09 -0700
Subject: kernel-dev: Updated step 1 of flow and intro verbiage

Updated the step to include proper links and verbiage for
setting up the system for YP development.

(From yocto-docs rev: d5d908847d66178a995d2be985c605e6a5c48d76)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 documentation/kernel-dev/kernel-dev-intro.xml | 29 ++++++++++++++++++++++-----
 1 file changed, 24 insertions(+), 5 deletions(-)

(limited to 'documentation')

diff --git a/documentation/kernel-dev/kernel-dev-intro.xml b/documentation/kernel-dev/kernel-dev-intro.xml
index 9080ddc1b8..9104ed4d87 100644
--- a/documentation/kernel-dev/kernel-dev-intro.xml
+++ b/documentation/kernel-dev/kernel-dev-intro.xml
@@ -11,7 +11,8 @@
     <para>
         Regardless of how you intend to make use of the Yocto Project,
         chances are you will work with the Linux kernel.
-        This manual introduces the kernel development process and
+        This manual describes how to set up your build host to support
+        kernel development, introduces the kernel development process,
         provides background information on the Yocto Linux kernel
         <ulink url='&YOCTO_DOCS_REF_URL;#metadata'>Metadata</ulink>,
         describes common tasks you can perform using the kernel tools,
@@ -93,11 +94,27 @@
 <section id='preparing-the-build-host-to-work-on-the-kernel'>
     <title>Preparing the Build Host to Work on the Kernel</title>
 
+    <para>
+        Before you can do any kernel development, you need to be
+        sure your build host is set up to use the Yocto Project.
+        For information on how to get set up, see the
+        "<ulink url='&YOCTO_DOCS_DEV_URL;#setting-up-the-development-host-to-use-the-yocto-project'>Setting Up to Use the Yocto Project</ulink>"
+        section in the Yocto Project Development Manual.
+        Part of preparing the system is creating a local Git
+        repository of the
+        <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>
+        (<filename>poky</filename>) on your system.
+        Follow the steps in the
+        "<ulink url='&YOCTO_DOCS_DEV_URL;#cloning-the-poky-repository'>Cloning the <filename>poky</filename> Repository</ulink>"
+        section in the Yocto Project Development Manual to set up your
+        Source Directory.
+    </para>
+
     <para>
         Kernel development is best accomplished using
         <ulink url='&YOCTO_DOCS_SDK_URL;#using-devtool-in-your-sdk-workflow'><filename>devtool</filename></ulink>
         and not through traditional kernel workflow methods.
-        This section provides information for both scenarios.
+        The remainder of this section provides information for both scenarios.
     </para>
 
     <section id='getting-ready-to-develop-using-devtool'>
@@ -254,9 +271,11 @@
                 <emphasis>Set up Your Host Development System to Support
                 Development Using the Yocto Project</emphasis>:
                 See the
-                "<ulink url='&YOCTO_DOCS_QS_URL;#yp-resources'>Setting Up to Use the Yocto Project</ulink>"
-                section in the Yocto Project Quick Start for options on how
-                to get a build host ready to use the Yocto Project.
+                "<link linkend='preparing-the-build-host-to-work-on-the-kernel'>Preparing the Build Host to Work on the Kernel</link>"
+                section and be sure you have everything set up to use the
+                Yocto Project, including a local Git repository of the
+                <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>
+                (<filename>poky</filename>).
                 </para></listitem>
             <listitem><para>
                 <emphasis>Establish the Temporary Kernel Source Files</emphasis>:
-- 
cgit v1.2.3-54-g00ecf