generic-poky/documentation/poky-ref-manual/resources.xml

<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<appendix id='resources'>
<title>Contributing to the Yocto Project</title>

<section id='resources-intro'>
    <title>Introduction</title>
    <para>
        The Yocto Project team is happy for people to experiment with the Yocto Project.
        A number of places exist to find help if you run into difficulties or find bugs. 
        To find out how to download source code,
        see the <ulink url='http://www.yoctoproject.org/docs/1.1/dev-manual/dev-manual.html#local-yp-release'>
        Yocto Project Release</ulink> list item in
        <ulink url='http://www.yoctoproject.org/docs/1.1/dev-manual/dev-manual.html'>The Yocto 
        Project Development Manual</ulink>.
    </para>
</section>

<section id='resources-bugtracker'>
    <title>Tracking Bugs</title>

    <para>
        If you find problems with the Yocto Project, you should report them using the 
        Bugzilla application at <ulink url='http://bugzilla.yoctoproject.org/'></ulink>.
    </para>
</section>

<section id='resources-mailinglist'>
    <title>Mailing lists</title>

    <para>
        To subscribe to the Yocto Project mailing lists, click on the following URLs and follow the instructions:
        <itemizedlist>
            <listitem><para><ulink url='http://lists.yoctoproject.org/listinfo/yocto'></ulink> for a 
                Yocto Discussions mailing list.</para></listitem>
            <listitem><para><ulink url='http://lists.yoctoproject.org/listinfo/poky'></ulink> for a 
                Yocto Project Discussions mailing list.</para></listitem>
            <listitem><para><ulink url='http://lists.yoctoproject.org/listinfo/yocto-announce'></ulink> for a 
                mailing list to receive offical Yocto Project announcements for developments and 
                as well as Yocto Project milestones.</para></listitem>
        </itemizedlist>
    </para>
</section>

<section id='resources-irc'>
    <title>Internet Relay Chat (IRC)</title>

    <para>
        Two IRC channels on freenode are available for Yocto Project and Poky discussions:
        <itemizedlist>
            <listitem><para><filename>#yocto</filename></para></listitem>
            <listitem><para><filename>#poky</filename></para></listitem>
        </itemizedlist>
    </para>
</section>

<section id='resources-links'>
    <title>Links</title>

    <para>
        Following is a list of resources you will find helpful:
        <itemizedlist>
            <listitem><para><emphasis><ulink url='http://yoctoproject.org'>The Yocto Project website</ulink>:
                </emphasis> The home site for the Yocto Project.</para></listitem>
            <listitem><para><emphasis><ulink url='http://www.openedhand.com/'>OpenedHand</ulink>:</emphasis>
                The company where the Yocto Project build system Poky was first developed.
                OpenedHand has since been acquired by Intel Corporation.</para></listitem>
            <listitem><para><emphasis><ulink url='http://www.intel.com/'>Intel Corporation</ulink>:</emphasis>
                The company who acquired OpenedHand in 2008 and continues development on the 
                Yocto Project.</para></listitem>
            <listitem><para><emphasis><ulink url='http://www.openembedded.org/'>OpenEmbedded</ulink>:</emphasis>
                The upstream, generic, embedded distribution the Yocto Project build system (Poky) derives
                from and to which it contributes.</para></listitem>
            <listitem><para><emphasis><ulink url='http://developer.berlios.de/projects/bitbake/'>
                Bitbake</ulink>:</emphasis> The tool used to process Yocto Project metadata.</para></listitem>
            <listitem><para><emphasis><ulink url='http://bitbake.berlios.de/manual/'>
                BitBake User Manual</ulink>:</emphasis> A comprehensive guide to the BitBake tool.
                </para></listitem>
            <listitem><para><emphasis><ulink url='http://pimlico-project.org/'>Pimlico</ulink>:</emphasis>
                A suite of lightweight Personal Information Management (PIM) applications designed 
                primarily for handheld and mobile devices.</para></listitem>
            <listitem><para><emphasis><ulink url='http://wiki.qemu.org/Index.html'>QEMU</ulink>:
                </emphasis> An open source machine emulator and virtualizer.</para></listitem>
        </itemizedlist>
    </para>
</section>

<section id='resources-contributions'>
    <title>Contributions</title>

    <para>
        Contributions to the Yocto Project are very welcome. 
        You should send patches to the Yocto Project mailing list along with a "signed-off-by:"
        line in the same style as required by the Linux kernel. 
        Adding this line signifies the developer has agreed to the Developer's Certificate of Origin 1.1
        as follows:
        <literallayout class='monospaced'>
     Developer's Certificate of Origin 1.1

     By making a contribution to this project, I certify that:

     (a) The contribution was created in whole or in part by me and I
         have the right to submit it under the open source license
         indicated in the file; or

     (b) The contribution is based upon previous work that, to the best
         of my knowledge, is covered under an appropriate open source
         license and I have the right under that license to submit that
         work with modifications, whether created in whole or in part
         by me, under the same open source license (unless I am
         permitted to submit under a different license), as indicated
         in the file; or

     (c) The contribution was provided directly to me by some other
         person who certified (a), (b) or (c) and I have not modified
         it.

     (d) I understand and agree that this project and the contribution
         are public and that a record of the contribution (including all
         personal information I submit with it, including my sign-off) is
         maintained indefinitely and may be redistributed consistent with
         this project or the open source license(s) involved.
        </literallayout>
        A Poky contributions tree (<filename>poky-contrib</filename>, 
        <filename>git://git.yoctoproject.org/poky-contrib.git</filename>)
        exists for contributors to stage contributions.
        If people desire such access, please ask on the mailing list. 
        Usually, the Yocto Project team will grant access to anyone with a proven track 
        record of good patches.
    </para>
</section>

</appendix>
<!-- 
vim: expandtab tw=80 ts=4 
-->