summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/resources.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual/resources.xml')
-rw-r--r--documentation/ref-manual/resources.xml224
1 files changed, 180 insertions, 44 deletions
diff --git a/documentation/ref-manual/resources.xml b/documentation/ref-manual/resources.xml
index 0cd0e5a254..c713ffcf11 100644
--- a/documentation/ref-manual/resources.xml
+++ b/documentation/ref-manual/resources.xml
@@ -3,15 +3,31 @@
3[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > 3[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
4 4
5<chapter id='resources'> 5<chapter id='resources'>
6<title>Contributing to the Yocto Project</title> 6<title>Contributions and Additional Information</title>
7 7
8<section id='resources-intro'> 8<section id='resources-intro'>
9 <title>Introduction</title> 9 <title>Introduction</title>
10 <para> 10 <para>
11 The Yocto Project team is happy for people to experiment with the Yocto Project. 11 The Yocto Project team is happy for people to experiment with the
12 A number of places exist to find help if you run into difficulties or find bugs. 12 Yocto Project.
13 To find out how to download source code, 13 A number of places exist to find help if you run into difficulties
14 see the "<ulink url='&YOCTO_DOCS_DEV_URL;#local-yp-release'>Yocto Project Release</ulink>" 14 or find bugs.
15 This presents information about contributing and participating in
16 the Yocto Project.
17 </para>
18</section>
19
20<section id='resources-contributions'>
21 <title>Contributions</title>
22
23 <para>
24 The Yocto Project gladly accepts contributions.
25 You can submit changes to the project either by creating and sending
26 pull requests,
27 or by submitting patches through email.
28 For information on how to do both as well as information on how
29 to identify the maintainer for each area of code, see the
30 "<ulink url='&YOCTO_DOCS_DEV_URL;#how-to-submit-a-change'>How to Submit a Change</ulink>"
15 section in the Yocto Project Development Manual. 31 section in the Yocto Project Development Manual.
16 </para> 32 </para>
17</section> 33</section>
@@ -100,53 +116,173 @@
100 </para> 116 </para>
101</section> 117</section>
102 118
103<section id='resources-links'> 119<section id='resources-links-and-related-documentation'>
104 <title>Links</title> 120 <title>Links and Related Documentation</title>
105 121
106 <para> 122 <para>
107 Here is a list of resources you will find helpful: 123 Here is a list of resources you might find helpful:
108 <itemizedlist> 124 <itemizedlist>
109 <listitem><para><emphasis> 125 <listitem><para>
126 <emphasis>
110 <ulink url='&YOCTO_HOME_URL;'>The Yocto Project website</ulink>: 127 <ulink url='&YOCTO_HOME_URL;'>The Yocto Project website</ulink>:
111 </emphasis> The home site for the Yocto 128 </emphasis> The home site for the Yocto Project.
112 Project.</para></listitem> 129 </para></listitem>
113<!-- 130 <listitem><para>
114 <listitem><para><emphasis> 131 <emphasis>
115 <ulink url='http://www.intel.com/'>Intel Corporation</ulink>:</emphasis> 132 <ulink url='&YOCTO_WIKI_URL;/wiki/Main_Page'>The Yocto Project Main Wiki Page</ulink>:
116 The company that acquired OpenedHand in 2008 and began 133 </emphasis>
117 development on the Yocto Project.</para></listitem> 134 The main wiki page for the Yocto Project.
118--> 135 This page contains information about project planning,
119 <listitem><para><emphasis> 136 release engineering, QA &amp; automation, a reference
120 <ulink url='&OE_HOME_URL;'>OpenEmbedded</ulink>:</emphasis> 137 site map, and other resources related to the Yocto Project.
121 The upstream, generic, embedded distribution used as the basis 138 </para></listitem>
122 for the build system in the Yocto Project. 139 <listitem><para>
123 Poky derives from and contributes back to the OpenEmbedded 140 <emphasis>
124 project.</para></listitem> 141 <ulink url='&OE_HOME_URL;'>OpenEmbedded</ulink>:
125 <listitem><para><emphasis> 142 </emphasis>
143 The build system used by the Yocto Project.
144 This project is the upstream, generic, embedded distribution
145 from which the Yocto Project derives its build system (Poky)
146 and to which it contributes.
147 </para></listitem>
148 <listitem><para>
149 <emphasis>
126 <ulink url='http://www.openembedded.org/wiki/BitBake'> 150 <ulink url='http://www.openembedded.org/wiki/BitBake'>
127 BitBake</ulink>:</emphasis> The tool used to process metadata.</para></listitem> 151 BitBake</ulink>:
152 </emphasis> The tool used to process metadata.
153 </para></listitem>
154 <listitem><para>
155 <emphasis>
156 <ulink url='&YOCTO_DOCS_BB_URL;'>BitBake User Manual:</ulink>
157 </emphasis>
158 A comprehensive guide to the BitBake tool.
159 If you want information on BitBake, see this manual.
160 </para></listitem>
161 <listitem><para>
162 <emphasis>
163 <ulink url='&YOCTO_DOCS_QS_URL;'>Yocto Project Quick Start</ulink>:
164 </emphasis>
165 This short document lets you get started
166 with the Yocto Project and quickly begin building an image.
167 </para></listitem>
168 <listitem><para>
169 <emphasis>
170 <ulink url='&YOCTO_DOCS_DEV_URL;'>Yocto Project Development Manual</ulink>:
171 </emphasis>
172 This manual is a "how-to" guide that presents procedures
173 useful to both application and system developers who use the
174 Yocto Project.
175 </para></listitem>
176 <listitem><para>
177 <emphasis>
178 <ulink url='&YOCTO_DOCS_SDK_URL;'>Yocto Project Software Development Kit (SDK) Developer's Guide</ulink>:
179 </emphasis>
180 This guide provides information that lets you get going
181 with the standard or extensible SDK.
182 An SDK, with its cross-development toolchains, allows you
183 to develop projects inside or outside of the Yocto Project
184 environment.
185 </para></listitem>
186 <listitem><para>
187 <emphasis>
188 <ulink url='&YOCTO_DOCS_BSP_URL;'>Yocto Project Board Support Package (BSP) Developer's Guide</ulink>:
189 </emphasis>
190 This guide defines the structure for BSP components.
191 Having a commonly understood structure encourages
192 standardization.
193 </para></listitem>
194 <listitem><para>
195 <emphasis>
196 <ulink url='&YOCTO_DOCS_KERNEL_DEV_URL;'>Yocto Project Linux Kernel Development Manual</ulink>:
197 </emphasis>
198 This manual describes how to work with Linux Yocto kernels as
199 well as provides a bit of conceptual information on the
200 construction of the Yocto Linux kernel tree.
201 </para></listitem>
202 <listitem><para>
203 <emphasis>
204 <ulink url='&YOCTO_DOCS_PROF_URL;'>Yocto Project Profiling and Tracing Manual</ulink>:
205 </emphasis>
206 This manual presents a set of common and generally useful
207 tracing and profiling schemes along with their applications
208 (as appropriate) to each tool.
209 </para></listitem>
210 <listitem><para>
211 <emphasis>
212 <ulink url='&YOCTO_DOCS_SDK_URL;#sdk-appendix-latest-yp-eclipse-plug-in'>Eclipse IDE Yocto Plug-in</ulink>:
213 </emphasis>
214 Instructions that demonstrate how an application developer
215 uses the Eclipse Yocto Project Plug-in feature within
216 the Eclipse IDE.
217 </para></listitem>
218 <listitem><para>
219 <emphasis>
220 <ulink url='&YOCTO_WIKI_URL;/wiki/FAQ'>FAQ</ulink>:
221 </emphasis>
222 A list of commonly asked questions and their answers.
223 </para></listitem>
224 <listitem><para>
225 <emphasis>
226 <ulink url='&YOCTO_RELEASE_NOTES;'>Release Notes</ulink>:
227 </emphasis>
228 Features, updates and known issues for the current
229 release of the Yocto Project.
230 </para></listitem>
231 <listitem><para>
232 <emphasis>
233 <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/toaster'>Toaster</ulink>:
234 </emphasis>
235 An Application Programming Interface (API) and web-based
236 interface to the OpenEmbedded build system, which uses
237 BitBake, that reports build information.
238 </para></listitem>
239 <listitem><para>
240 <emphasis>
241 <ulink url='&YOCTO_DOCS_TOAST_URL;'>Toaster User Manual</ulink>:
242 </emphasis>
243 This manual introduces and describes how to set up and use
244 Toaster, which is a web interface to the Yocto Project's
245 <ulink url='&YOCTO_DOCS_DEV_URL;#build-system-term'>OpenEmbedded Build System</ulink>.
246 </para></listitem>
247 <listitem><para>
248 <emphasis>
249 <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/build-appliance'>Build Appliance</ulink>:
250 </emphasis>
251 A virtual machine that
252 enables you to build and boot a custom embedded Linux image
253 with the Yocto Project using a non-Linux development system.
254 </para></listitem>
255 <listitem><para>
256 <emphasis>
257 <ulink url='&YOCTO_BUGZILLA_URL;'>Bugzilla</ulink>:
258 </emphasis>
259 The bug tracking application the Yocto Project uses.
260 If you find problems with the Yocto Project, you should report
261 them using this application.
262 </para></listitem>
263 <listitem><para>
264 <emphasis>
265 <ulink url='&YOCTO_WIKI_URL;/wiki/Bugzilla_Configuration_and_Bug_Tracking'>Bugzilla Configuration and Bug Tracking Wiki Page</ulink>:
266 </emphasis>
267 Information on how to get set up and use the Yocto Project
268 implementation of Bugzilla for logging and tracking Yocto
269 Project defects.
270 </para></listitem>
271 <listitem><para>
272 <emphasis>Internet Relay Chat (IRC):</emphasis>
273 Two IRC channels on freenode are available
274 for Yocto Project and Poky discussions: <filename>#yocto</filename> and
275 <filename>#poky</filename>, respectively.
276 </para></listitem>
277 <listitem><para>
278 <emphasis>
279 <ulink url='http://wiki.qemu.org/Index.html'>Quick EMUlator (QEMU)</ulink>:
280 </emphasis>
281 An open-source machine emulator and virtualizer.
282 </para></listitem>
128 </itemizedlist> 283 </itemizedlist>
129 For more links, see the
130 "<ulink url='&YOCTO_DOCS_DEV_URL;#other-information'>Other Information</ulink>"
131 section in the Yocto Project Development Manual.
132 </para>
133</section>
134
135<section id='resources-contributions'>
136 <title>Contributions</title>
137
138 <para>
139 The Yocto Project gladly accepts contributions.
140 You can submit changes to the project either by creating and sending
141 pull requests,
142 or by submitting patches through email.
143 For information on how to do both as well as information on how
144 to identify the maintainer for each area of code, see the
145 "<ulink url='&YOCTO_DOCS_DEV_URL;#how-to-submit-a-change'>How to Submit a Change</ulink>"
146 section in the Yocto Project Development Manual.
147 </para> 284 </para>
148</section> 285</section>
149
150</chapter> 286</chapter>
151<!-- 287<!--
152vim: expandtab tw=80 ts=4 288vim: expandtab tw=80 ts=4