documentation/dev-manual/dev-manual-newbie.xml: updated intro paragraph and figs

I updated the introduction paragraph to cast the chapter more for YP than
just generic newbie information.  Also, added three screenshots for
the source areas at Dave Stewart's suggestion.

(From yocto-docs rev: 26d3c58ff6295515c593c8b0b12dc3d6952b752a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2011-08-01 16:18:23 -07:00 committed by Richard Purdie
parent e3687ca853
commit e4448dac93
1 changed files with 20 additions and 15 deletions

View File

@ -3,21 +3,18 @@
<chapter id='dev-manual-newbie'>
<title>Working with Open Source Code</title>
<title>The Yocto Project Open Source Development Environment</title>
<para>
This chapter presents information for users new or unfamiliar with working in an open source environment.
Working in this type of environment is different than working in a closed, proprietary environment.
The chapter also presents information specific to the Yocto Project environment.
It specifically addresses licensing issues, code repositories, the open-source distributed version control
system Git, and best practices using Yocto Project.
This chapter helps you understand the Yocto Project as an open source development project.
In general, working in an open-source environment is very different than working in a closed,
proprietary environment.
Additionally, the Yocto Project uses specific tools and constructs as part of its development
environment.
The chapter specifically addresses open source philosophy, licensing issues, code repositories,
the open source distributed version control system Git, and best practices using Yocto Project.
</para>
<note><para>
If you are a seasoned open source developer and are familiar with Git, you might just be interested
in the Yocto Project specific information in this chapter.
</para></note>
<section id='open-source-philosophy'>
<title>Open Source Philosophy</title>
@ -102,18 +99,26 @@
<listitem><para><emphasis><ulink url='http://git.yoctoproject.org/cgit/cgit.cgi'>Source Repositories:</ulink></emphasis>
This area contains IDE Plugins, Matchbox, Poky, Poky Support, Tools, Yocto Linux Kernel, and Yocto
Metadata Layers.
You can create Git repositories for each of these areas.</para></listitem>
You can create Git repositories for each of these areas.</para>
<para>
<imagedata fileref="figures/source-repos.png" align="center" width="6in" depth="4in" />
</para></listitem>
<listitem><para><emphasis><ulink url='http://autobuilder.yoctoproject.org/downloads/'>Index of /downloads:</ulink></emphasis>
This area contains an index of the Eclipse-plugin, miscellaneous support, poky, pseudo, and
all released versions of Yocto Project in the form of images or tarballs.
Downloading and extracting these files does not produce a Git repository but rather
a snapshot of a particular release or image.
[WRITER NOTE: link will be http://downloads.yoctoproject.org.]</para></listitem>
[WRITER NOTE: link will be http://downloads.yoctoproject.org.]</para>
<para>
<imagedata fileref="figures/index-downloads.png" align="center" width="6in" depth="4in" />
</para></listitem>
<listitem><para><emphasis><ulink url='http://www.yoctoproject.org/download'>Yocto Project Download Page</ulink></emphasis>
This page on the Yocto Project website allows you to download any Yocto Project
release of Board Support Package (BSP) in tarball form.
release or Board Support Package (BSP) in tarball form.
The tarballs are similar to those found in the
<ulink url='http://autobuilder.yoctoproject.org/downloads/'>Index of /downloads:</ulink> area.
<ulink url='http://autobuilder.yoctoproject.org/downloads/'>Index of /downloads:</ulink> area.</para>
<para>
<imagedata fileref="figures/yp-download.png" align="center" width="6in" depth="4in" />
</para></listitem>
</itemizedlist>
</para>