1.. SPDX-License-Identifier: CC-BY-SA-2.0-UK 2 3**************************************** 4Contributions and Additional Information 5**************************************** 6 7.. _resources-intro: 8 9Introduction 10============ 11 12The Yocto Project team is happy for people to experiment with the Yocto 13Project. There is a number of places where you can find help if you run into 14difficulties or find bugs. This presents information about contributing 15and participating in the Yocto Project. 16 17.. _resources-contributions: 18 19Contributions 20============= 21 22The Yocto Project gladly accepts contributions. You can submit changes 23to the project either by creating and sending pull requests, or by 24submitting patches through email. For information on how to do both as 25well as information on how to identify the maintainer for each area of 26code, see the ":ref:`dev-manual/changes:submitting a change to the yocto project`" section in the 27Yocto Project Development Tasks Manual. 28 29.. _resources-bugtracker: 30 31Yocto Project Bugzilla 32====================== 33 34The Yocto Project uses its own implementation of 35:yocto_bugs:`Bugzilla <>` to track defects (bugs). 36Implementations of Bugzilla work well for group development because they 37track bugs and code changes, can be used to communicate changes and 38problems with developers, can be used to submit and review patches, and 39can be used to manage quality assurance. 40 41Sometimes it is helpful to submit, investigate, or track a bug against 42the Yocto Project itself (e.g. when discovering an issue with some 43component of the build system that acts contrary to the documentation or 44your expectations). 45 46For a general procedure and guidelines on how to use Bugzilla to submit a bug 47against the Yocto Project, see the following: 48 49- The ":ref:`dev-manual/changes:submitting a defect against the yocto project`" 50 section in the Yocto Project Development Tasks Manual. 51 52- The Yocto Project :yocto_wiki:`Bugzilla wiki page </Bugzilla_Configuration_and_Bug_Tracking>` 53 54For information on Bugzilla in general, see https://www.bugzilla.org/about/. 55 56.. _resources-mailinglist: 57 58Mailing lists 59============= 60 61There are multiple mailing lists maintained by the Yocto Project as well 62as related OpenEmbedded mailing lists for discussion, patch submission 63and announcements. To subscribe to one of the following mailing lists, 64click on the appropriate URL in the following list and follow the 65instructions: 66 67- :yocto_lists:`/g/yocto` --- general Yocto Project 68 discussion mailing list. 69 70- :oe_lists:`/g/openembedded-core` --- discussion mailing 71 list about OpenEmbedded-Core (the core metadata). 72 73- :oe_lists:`/g/openembedded-devel` --- discussion 74 mailing list about OpenEmbedded. 75 76- :oe_lists:`/g/bitbake-devel` --- discussion mailing 77 list about the :term:`BitBake` build tool. 78 79- :yocto_lists:`/g/poky` --- discussion mailing list 80 about :term:`Poky`. 81 82- :yocto_lists:`/g/yocto-announce` --- mailing list to 83 receive official Yocto Project release and milestone announcements. 84 85- :yocto_lists:`/g/docs` --- discussion mailing list about the Yocto Project 86 documentation. 87 88See also :yocto_home:`the description of all mailing lists </community/mailing-lists/>`. 89 90.. _resources-irc: 91 92Internet Relay Chat (IRC) 93========================= 94 95Two IRC channels on `Libera Chat <https://libera.chat/>`__ 96are available for the Yocto Project and OpenEmbedded discussions: 97 98- ``#yocto`` 99 100- ``#oe`` 101 102.. _resources-links-and-related-documentation: 103 104Links and Related Documentation 105=============================== 106 107Here is a list of resources you might find helpful: 108 109- :yocto_home:`The Yocto Project Website <>`: The home site 110 for the Yocto Project. 111 112- :yocto_wiki:`The Yocto Project Main Wiki Page <>`: The main wiki page for 113 the Yocto Project. This page contains information about project 114 planning, release engineering, QA & automation, a reference site map, 115 and other resources related to the Yocto Project. 116 117- :oe_home:`OpenEmbedded <>`: The build system used by the 118 Yocto Project. This project is the upstream, generic, embedded 119 distribution from which the Yocto Project derives its build system 120 (Poky) and to which it contributes. 121 122- :oe_wiki:`BitBake </BitBake>`: The tool used to process metadata. 123 124- :doc:`BitBake User Manual <bitbake:index>`: A comprehensive 125 guide to the BitBake tool. If you want information on BitBake, see 126 this manual. 127 128- :doc:`/brief-yoctoprojectqs/index`: This 129 short document lets you experience building an image using the Yocto 130 Project without having to understand any concepts or details. 131 132- :doc:`/overview-manual/index`: This manual provides overview 133 and conceptual information about the Yocto Project. 134 135- :doc:`/dev-manual/index`: This manual is a "how-to" guide 136 that presents procedures useful to both application and system 137 developers who use the Yocto Project. 138 139- :doc:`/sdk-manual/index` manual: This 140 guide provides information that lets you get going with the standard 141 or extensible SDK. An SDK, with its cross-development toolchains, 142 allows you to develop projects inside or outside of the Yocto Project 143 environment. 144 145- :doc:`/bsp-guide/bsp`: This guide defines the structure 146 for BSP components. Having a commonly understood structure encourages 147 standardization. 148 149- :doc:`/kernel-dev/index`: This manual describes 150 how to work with Linux Yocto kernels as well as provides a bit of 151 conceptual information on the construction of the Yocto Linux kernel 152 tree. 153 154- :doc:`/ref-manual/index`: This 155 manual provides reference material such as variable, task, and class 156 descriptions. 157 158- :yocto_docs:`Yocto Project Mega-Manual </singleindex.html>`: This manual 159 is simply a single HTML file comprised of the bulk of the Yocto 160 Project manuals. It makes it easy to search for phrases and terms used 161 in the Yocto Project documentation set. 162 163- :doc:`/profile-manual/index`: This manual presents a set of 164 common and generally useful tracing and profiling schemes along with 165 their applications (as appropriate) to each tool. 166 167- :doc:`/toaster-manual/index`: This manual 168 introduces and describes how to set up and use Toaster. Toaster is an 169 Application Programming Interface (API) and web-based interface to 170 the :term:`OpenEmbedded Build System`, which uses 171 BitBake, that reports build information. 172 173- :yocto_wiki:`FAQ </FAQ>`: A list of commonly asked 174 questions and their answers. 175 176- :doc:`Release Information </migration-guides/index>`: 177 Migration guides, release notes, new features, updates and known issues 178 for the current and past releases of the Yocto Project. 179 180- :yocto_bugs:`Bugzilla <>`: The bug tracking application 181 the Yocto Project uses. If you find problems with the Yocto Project, 182 you should report them using this application. 183 184- :yocto_wiki:`Bugzilla Configuration and Bug Tracking Wiki Page 185 </Bugzilla_Configuration_and_Bug_Tracking>`: 186 Information on how to get set up and use the Yocto Project 187 implementation of Bugzilla for logging and tracking Yocto Project 188 defects. 189 190- Internet Relay Chat (IRC): Two IRC channels on 191 `Libera Chat <https://libera.chat/>`__ are 192 available for Yocto Project and OpenEmbeddded discussions: ``#yocto`` and 193 ``#oe``, respectively. 194 195- `Quick EMUlator (QEMU) <https://wiki.qemu.org/Index.html>`__: An 196 open-source machine emulator and virtualizer. 197