summaryrefslogtreecommitdiffstats
path: root/documentation/concepts-manual/concepts-manual-intro.xml
blob: adaa612525aec4920284c71254501125f6d96d45 (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
<!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='concepts-manual-intro'>

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

        <para>
            Welcome to the Yocto Project Concepts Manual!
            This manual provides conceptual information that helps you
            better understand the Yocto Project.
            You can learn about Yocto Project components,
            cross-development toolchain generation, shared-state cache,
            and many other concepts.
        </para>

        <para>
            This manual does not give you the following:
            <itemizedlist>
                <listitem><para>
                    <emphasis>Complete 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>Getting Started Material:</emphasis>
                    This type of material resides in the
                    <ulink url='&YOCTO_DOCS_GS_URL;'>Getting Started With Yocto Project Manual</ulink>.
                    </para></listitem>
                <listitem><para>
                    <emphasis>Detailed Public Information Not Specific to the
                    Yocto Project:</emphasis>
                    For example, exhaustive information on how to use Git
                    is better covered with Internet searches and official
                    Git Documentation than through the Yocto Project
                    documentation.
                    </para></listitem>
            </itemizedlist>
        </para>
    </section>

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

        <para>
            Because this manual presents information for many different
            concepts, 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
-->