documenation/dev-manual/dev-manual-model.xml: Hob section first draft

(From yocto-docs rev: 02eb8ac5016ef347a554dfdd214d3e66342f0ee2)

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

1 files changed, 32 insertions, 0 deletions

diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml
index f7d9336fe8..29840ee720 100644
--- a/documentation/dev-manual/dev-manual-model.xml
+++ b/documentation/dev-manual/dev-manual-model.xml
@@ -692,6 +692,38 @@ WRITER NOTE:  The areas to get the kernel and root filesystem are located in the
 <section id='image-development-using-hob'>
     <title>Image Development Using Hob</title>
 
+    <para>
+        The <ulink url='&YOCTO_HOME_URL;/projects/hob'>Hob</ulink> is a graphical user interface for the Yocto 
+        Project build system based on BitBake.
+        You can use the Hob to build custom operating system images within the Yocto Project build environment.
+        Hob simply provides a friendly interface over the build system used during system development.
+        In other words, building images with the Hob lets you take care of common Yocto Project build tasks more easily.
+    </para>
+
+    <para>
+        For a better understanding of Hob, see the project page at
+        <ulink url='&YOCTO_HOME_URL;/projects/hob'></ulink> on the Yocto Project website.
+        The page has a short introductory training video on Hob.
+        The following lists some features of Hob:
+        <itemizedlist>
+            <listitem><para>You can setup and run Hob using these commands:
+            <literallayout class='monospaced'>
+     $ source oe-init-build-env
+     $ hob
+            </literallayout></para></listitem>
+            <listitem><para>You can set the 
+                <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>
+                for which you are building the image.</para></listitem>
+            <listitem><para>You can modify various policy settings such as the package format used to build with, 
+                the parrallelism BitBake uses, whether or not to build an external toolchain, and which host 
+                to build against.</para></listitem>
+            <listitem><para>You can manage <link linkend='understanding-and-creating-layers'>Understanding 
+                and Creating layers</link>.</para></listitem>
+            <listitem><para>You can select a base image and then add extra packages for your custom build.
+                </para></listitem>
+            <listitem><para>You can launch and monitor the build from within Hob.</para></listitem>
+        </itemizedlist>
+    </para>
 </section>
 
 </chapter>