summaryrefslogtreecommitdiffstats
path: root/documentation/overview-manual/overview-manual-intro.xml
blob: 51a21b6e23f9393cc0da6b16415dac7009b2c1c5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >

<chapter id='overview-manual-intro'>

<title>The Yocto Project Overview Manual</title>
    <section id='overview-welcome'>
        <title>Welcome</title>

        <para>
            Welcome to the Yocto Project Overview Manual!
            This manual introduces the Yocto Project by providing concepts,
            software overviews, best-known-methods (BKMs), and any other
            high-level introductory information suitable for a new Yocto
            Project user.
        </para>

        <para>
            The following list describes what you can get from this manual:
            <itemizedlist>
                <listitem><para>
                    <emphasis>Major Topic:</emphasis>
                    Provide a high-level description of this major topic.
                    </para></listitem>
                <listitem><para>
                    <emphasis>Major Topic:</emphasis>
                    Provide a high-level description of this major topic.
                    </para></listitem>
                <listitem><para>
                    <emphasis>Major Topic:</emphasis>
                    Provide a high-level description of this major topic.
                    </para></listitem>
                <listitem><para>
                    <emphasis>Major Topic:</emphasis>
                    Provide a high-level description of this major topic.
                    </para></listitem>
            </itemizedlist>
        </para>

        <para>
            This manual does not give you the following:
            <itemizedlist>
                <listitem><para>
                    <emphasis>Step-by-step Instructions for Development Tasks:</emphasis>
                    Instructional procedures reside in other manuals within
                    the Yocto Project documentation set.
                    For example, the
                    <ulink url='&YOCTO_DOCS_DEV_URL;'>Yocto Project Development Tasks Manual</ulink>
                    provides examples on how to perform various development
                    tasks.
                    As another example, the
                    <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
                    SDK, which is used to develop applications for target
                    hardware.
                    </para></listitem>
                <listitem><para>
                    <emphasis>Reference Material:</emphasis>
                    This type of material resides in an appropriate reference
                    manual.
                    For example, system variables are documented in the
                    <ulink url='&YOCTO_DOCS_REF_URL;'>Yocto Project Reference Manual</ulink>.
                    As another example, the
                    <ulink url='&YOCTO_DOCS_BSP_URL;'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>
                    contains reference information on BSPs.
                    </para></listitem>
                <listitem><para>
                    <emphasis>Detailed Public Information Not Specific to the
                    Yocto Project:</emphasis>
                    For example, exhaustive information on how to use the
                    Source Control Manager Git is better covered with Internet
                    searches and official Git Documentation than through the
                    Yocto Project documentation.
                    </para></listitem>
            </itemizedlist>
        </para>
    </section>

    <section id='overview-other-information'>
        <title>Other Information</title>

        <para>
            Because this manual presents information for many different
            topics, supplemental information is recommended for full
            comprehension.
            For additional introductory information on the Yocto Project, see
            the <ulink url='&YOCTO_HOME_URL;'>Yocto Project Website</ulink>.
            You can find an introductory to using the Yocto Project by working
            through the
            <ulink url='&YOCTO_DOCS_QS_URL;'>Yocto Project Quick Start</ulink>.
        </para>

        <para>
            For a comprehensive list of links and other documentation, see the
            "<ulink url='&YOCTO_DOCS_REF_URL;#resources-links-and-related-documentation'>Links and Related Documentation</ulink>"
            section in the Yocto Project Reference Manual.
        </para>
    </section>
</chapter>
<!--
vim: expandtab tw=80 ts=4
-->