dev-manual: Updated intro chapter

The chapter was not the best given the new nature of the manual.  I added
better introductory wording.

(From yocto-docs rev: cb4695575c0105e0cd5e50c2132e98553babe147)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2018-05-16 10:47:21 -07:00
committed by Richard Purdie
parent 15fa336a1f
commit ef3b230abf

View File

@@ -16,33 +16,29 @@
The manual groups related procedures into higher-level sections. The manual groups related procedures into higher-level sections.
Procedures can consist of high-level steps or low-level steps Procedures can consist of high-level steps or low-level steps
depending on the topic. depending on the topic.
You can find conceptual information related to a procedure by
following appropriate links to the Yocto Project Reference
Manual.
</para> </para>
<para> <para>
The following list describes what you can get from this manual: The following list describes what you can get from this manual:
<itemizedlist> <itemizedlist>
<listitem><para> <listitem><para>
<emphasis>Setup Procedures:</emphasis> Procedures that help you get going with the Yocto Project.
Procedures that show you how to set For example, procedures that show you how to set up
up a Yocto Project Development environment and how a build host and work with the Yocto Project
to accomplish the change workflow through logging source repositories.
defects and submitting changes.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
<emphasis>Emulation Procedures:</emphasis> Procedures that show you how to submit changes to the
Procedures that show you how to use the Yocto Project.
Yocto Project integrated QuickEMUlator (QEMU), which lets Changes can be improvements, new features, or bug
you simulate running on hardware an image you have built fixes.
using the OpenEmbedded build system.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
<emphasis>Common Procedures:</emphasis>
Procedures related to "everyday" tasks you perform while Procedures related to "everyday" tasks you perform while
developing images and applications using the Yocto developing images and applications using the Yocto
Project. Project.
For example, procedures to create a layer, customize an
image, write a new recipe, and so forth.
</para></listitem> </para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
@@ -51,7 +47,7 @@
This manual will not give you the following: This manual will not give you the following:
<itemizedlist> <itemizedlist>
<listitem><para> <listitem><para>
<emphasis>Redundant Step-by-step Instructions:</emphasis> Redundant Step-by-step Instructions:
For example, the For example, the
<ulink url='&YOCTO_DOCS_SDK_URL;'>Yocto Project Application Development and the Extensible Software Development Kit (eSDK)</ulink> <ulink url='&YOCTO_DOCS_SDK_URL;'>Yocto Project Application Development and the Extensible Software Development Kit (eSDK)</ulink>
manual contains detailed instructions on how to install an manual contains detailed instructions on how to install an
@@ -59,14 +55,15 @@
hardware. hardware.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
<emphasis>Reference or Conceptual Material:</emphasis> Reference or Conceptual Material:
This type of material resides in an appropriate reference manual. This type of material resides in an appropriate reference
manual.
For example, system variables are documented in the For example, system variables are documented in the
<ulink url='&YOCTO_DOCS_REF_URL;'>Yocto Project Reference Manual</ulink>. <ulink url='&YOCTO_DOCS_REF_URL;'>Yocto Project Reference Manual</ulink>.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
<emphasis>Detailed Public Information Not Specific to the Detailed Public Information Not Specific to the
Yocto Project:</emphasis> Yocto Project:
For example, exhaustive information on how to use the For example, exhaustive information on how to use the
Source Control Manager Git is better covered with Internet Source Control Manager Git is better covered with Internet
searches and official Git Documentation than through the searches and official Git Documentation than through the