blob: 13c46b0c8e2c9ed5aa3602c37085d1b4b4683036 [file] [log] [blame] [view]
Francesco Servidio5dad5b72021-11-18 16:30:26 +01001# Patch submission
David Brownf1a78fc2017-06-20 12:57:27 -06002
Francesco Servidio5dad5b72021-11-18 16:30:26 +01003The development of MCUboot takes place in the [MCUboot GitHub
4repository](https://github.com/mcu-tools/mcuboot).
David Brownf1a78fc2017-06-20 12:57:27 -06005
Francesco Servidio5dad5b72021-11-18 16:30:26 +01006To submit patches, use GitHub pull requests.
David Brownf1a78fc2017-06-20 12:57:27 -06007
Francesco Servidio5dad5b72021-11-18 16:30:26 +01008Each commit has to have, in the commit message, a "Signed-off-by" line
9that mentions the author (and the committer, if that is different). You
10must add this line at the end of the commit text, separated by a blank
11line. You can also add a line linking the commit to a specific GitHub
12issue, as this section supports multiple lines, similarly to RFC-2822.
David Brownf1a78fc2017-06-20 12:57:27 -060013
Francesco Servidio5dad5b72021-11-18 16:30:26 +010014The supported trailer lines are structured as follows:
David Brownf1a78fc2017-06-20 12:57:27 -060015
Francesco Servidio5dad5b72021-11-18 16:30:26 +010016- A line that indicates that the signer agrees to the "Developer
17Certificate of Origin" located at the bottom of this page:
David Brownf1a78fc2017-06-20 12:57:27 -060018
Francesco Servidio5dad5b72021-11-18 16:30:26 +010019 ```
20 Signed-off-by: Developer Name <devname@example.com>
21 ```
David Brownf1a78fc2017-06-20 12:57:27 -060022
Francesco Servidio5dad5b72021-11-18 16:30:26 +010023- A line that links this commit to specific GitHub issues, if present:
David Brownf1a78fc2017-06-20 12:57:27 -060024
Francesco Servidio5dad5b72021-11-18 16:30:26 +010025 ```
26 Keyword #GH_issue_number
27 ```
28
29 For more details about linking a GitHub pull request to a GitHub issue,
30 see this [link]
31 (https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue).
32
33## Developer certificate of origin
34
35The following is the "Developer Certificate of Origin":
David Brownf1a78fc2017-06-20 12:57:27 -060036
37```
38Developer Certificate of Origin
39Version 1.1
40
41Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
421 Letterman Drive
43Suite D4700
44San Francisco, CA, 94129
45
46Everyone is permitted to copy and distribute verbatim copies of this
47license document, but changing it is not allowed.
48
49
50Developer's Certificate of Origin 1.1
51
52By making a contribution to this project, I certify that:
53
54(a) The contribution was created in whole or in part by me and I
55 have the right to submit it under the open source license
56 indicated in the file; or
57
58(b) The contribution is based upon previous work that, to the best
59 of my knowledge, is covered under an appropriate open source
60 license and I have the right under that license to submit that
61 work with modifications, whether created in whole or in part
62 by me, under the same open source license (unless I am
63 permitted to submit under a different license), as indicated
64 in the file; or
65
66(c) The contribution was provided directly to me by some other
67 person who certified (a), (b) or (c) and I have not modified
68 it.
69
70(d) I understand and agree that this project and the contribution
71 are public and that a record of the contribution (including all
72 personal information I submit with it, including my sign-off) is
73 maintained indefinitely and may be redistributed consistent with
74 this project or the open source license(s) involved.
75```