From 0f00914578740f4b4ca5216544d512e297610961 Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <srifenbark@gmail.com>
Date: Wed, 21 Jun 2017 15:07:41 -0700
Subject: documentation: Reorganized YP introduction material.

This material was being replicated across the Quick Start,
dev-manual, and ref-manual.  I have created a single point in the
ref-manual that collects the disparate information that existed.

I deleted the entire section in the dev-manual since that book
is converting to a procedure manual and the very front of the manual
adequately mentions YP and provides pointers to where the user can
get more information.

The QS provides a more complete introduction of YP since it is a
QS.

(From yocto-docs rev: bd8093417af2d93556410d5482dad32c11a0a964)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 documentation/ref-manual/introduction.xml | 41 +++++++++++++++++++++++--------
 1 file changed, 31 insertions(+), 10 deletions(-)

(limited to 'documentation/ref-manual/introduction.xml')

diff --git a/documentation/ref-manual/introduction.xml b/documentation/ref-manual/introduction.xml
index 98b3ca828c..473afb53ad 100644
--- a/documentation/ref-manual/introduction.xml
+++ b/documentation/ref-manual/introduction.xml
@@ -49,20 +49,41 @@
     <para>
         The Yocto Project is an open-source collaboration project whose
         focus is for developers of embedded Linux systems.
-        Among other things, the Yocto Project uses a build host based
-        on the OpenEmbedded (OE) project, which uses the
-        <ulink url='&YOCTO_DOCS_REF_URL;#bitbake-term'>BitBake</ulink>
-        tool, to construct complete Linux images.
-        The BitBake and OE components are combined together to form
-        a reference build host, historically known as
-        <ulink url='&YOCTO_DOCS_DEV_URL;#poky'>Poky</ulink>
-        (<emphasis>Pah</emphasis>-kee).
+        Among other things, the Yocto Project uses an
+        <link linkend='build-system-term'>OpenEmbedded build system</link>.
+        The build system, which is based on the OpenEmbedded (OE) project and
+        uses the
+        <link linkend='bitbake-term'>BitBake</link> tool, constructs complete
+        Linux images for architectures based on ARM, MIPS, PowerPC, x86 and
+        x86-64.
+        <note>
+            Historically, the OpenEmbedded build system, which is the
+            combination of BitBake and OE components, formed a reference
+            build host that was known as
+            "<link linkend='poky'>Poky</link>" (<emphasis>Pah</emphasis>-kee).
+            The term "Poky", as used throughout the Yocto Project Documentation
+            set, can have different meanings.
+        </note>
+        The Yocto Project provides various ancillary tools for the embedded
+        developer and also features the Sato reference User Interface, which
+        is optimized for stylus-driven, low-resolution screens.
+    </para>
+
+    <para>
+        While the Yocto Project does not provide a strict testing framework,
+        it does provide or generate for you artifacts that let you perform
+        target-level and emulated testing and debugging.
+        Additionally, if you are an
+        <trademark class='trade'>Eclipse</trademark> IDE user, you can
+        install an Eclipse Yocto Plug-in to allow you to develop within that
+        familiar environment.
     </para>
 
     <para>
-        By default, using the Yocto Project creates a Poky distribution.
+        By default, using the Yocto Project to build an image creates a Poky
+        distribution.
         However, you can create your own distribution by providing key
-        <ulink url='&YOCTO_DOCS_REF_URL;#metadata'>Metadata</ulink>.
+        <link link='metadata'>Metadata</link>.
         A good example is Angstrom, which has had a distribution
         based on the Yocto Project since its inception.
         Other examples include commercial distributions like
-- 
cgit v1.2.3-54-g00ecf