manual: contributing: expand introduction

This patch expands the introduction of the "Contributing to buildroot"
section. In general, the intention of this and subsequent patches is to
promote non-feature contributions, like autobuild fixes, bug report
analysis, TODO list work, etc.

Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
This commit is contained in:
Thomas De Schampheleire 2014-03-05 17:24:27 +01:00 committed by Thomas Petazzoni
parent ef008ebe06
commit 37b22be91d

View File

@ -2,26 +2,35 @@
// vim: set syntax=asciidoc: // vim: set syntax=asciidoc:
Contributing to Buildroot Contributing to Buildroot
======================== =========================
If you want to contribute to Buildroot, you will need a git view of There are many ways in which you can contribute to Buildroot: analyzing
the project. Refer to xref:getting-buildroot[] to get it. and fixing bugs, analyzing and fixing package build failures detected by
the autobuilders, testing and reviewing patches sent by other
developers, working on the items in our TODO list and sending your own
improvements to Buildroot or its manual. The following sections give a
little more detail on each of these items.
Currently, the mailing list is the central place for contribution. If you are interested in contributing to Buildroot, the first thing you
If you have not already subscribed to it, then refer to should do is to subscribe to the Buildroot mailing list. This list is
the main way of interacting with other Buildroot developers and to send
contributions to. If you aren't subscribed yet, then refer to
xref:mailing-list-subscribe[]. xref:mailing-list-subscribe[].
Recently, a web interface is also used to manage patches sent to the If you are going to touch the code, it is highly recommended to use a
mailing list, see xref:patchwork[]. git repository of Buildroot, rather than starting from an extracted
source code tarball. Git is the easiest way to develop from and directly
[NOTE] send your patches to the mailing list. Refer to xref:getting-buildroot[]
_Please, do not attach patches to bugs, send them to the mailing list for more information on obtaining a Buildroot git tree.
instead_ (see xref:submitting-patches[]).
[[submitting-patches]] [[submitting-patches]]
Submitting patches Submitting patches
------------------ ------------------
[NOTE]
_Please, do not attach patches to bugs, send them to the mailing list
instead_.
When your changes are done, and committed in your local git view, When your changes are done, and committed in your local git view,
_rebase_ your development branch on top of the upstream tree before _rebase_ your development branch on top of the upstream tree before
generating the patch set. To do so, run: generating the patch set. To do so, run: