blob: da104ec9880b670d98bed9ab5b515b4cb15ed771 [file] [log] [blame] [view]
David Brownf1a78fc2017-06-20 12:57:27 -06001# Submitting Patches
2
3Development on mcuboot primarily takes place in github, at:
4https://github.com/runtimeco/mcuboot
5
6Changes should be submitted via github pull requests. Each commit
7should have a Signed-off-by line for the author (and the committer, if
8that is different). It is not necessary (or possible) to get a
9Signed-off-by from Github itself, even though some commits may be
10generated by that tool.
11
12The Signed-off-by line should be at the end of the commit text, in the
13last blank-line-separated section. There can be multiple lines in
14this section (the format being roughly like RFC-2822). Currently
15supported trailer lines are:
16
17 Signed-off-by: Developer Name <devname@example.com>
18
19which indicates that the signer agrees to the Developer Certificate of
20Origin below, and
21
22 JIRA: MCUB-1234
23
24which associates this commit with a particular JIRA ticket. You can
25put more than one JIRA ticket, by separating them with a comma and a
26space. JIRA is quite flexible about where the indicators go, but
27putting them in a trailer with a common format will make them easier
28to find later.
29
30# Developer Certificate of Origin
31
32```
33Developer Certificate of Origin
34Version 1.1
35
36Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
371 Letterman Drive
38Suite D4700
39San Francisco, CA, 94129
40
41Everyone is permitted to copy and distribute verbatim copies of this
42license document, but changing it is not allowed.
43
44
45Developer's Certificate of Origin 1.1
46
47By making a contribution to this project, I certify that:
48
49(a) The contribution was created in whole or in part by me and I
50 have the right to submit it under the open source license
51 indicated in the file; or
52
53(b) The contribution is based upon previous work that, to the best
54 of my knowledge, is covered under an appropriate open source
55 license and I have the right under that license to submit that
56 work with modifications, whether created in whole or in part
57 by me, under the same open source license (unless I am
58 permitted to submit under a different license), as indicated
59 in the file; or
60
61(c) The contribution was provided directly to me by some other
62 person who certified (a), (b) or (c) and I have not modified
63 it.
64
65(d) I understand and agree that this project and the contribution
66 are public and that a record of the contribution (including all
67 personal information I submit with it, including my sign-off) is
68 maintained indefinitely and may be redistributed consistent with
69 this project or the open source license(s) involved.
70```