]>
Commit | Line | Data |
---|---|---|
fd0bef1e ДП |
1 | Contributing to this project |
2 | ---------------------------- | |
752c0602 | 3 | |
4 | This project accepts contributions. In order to contribute, you should | |
5 | pay attention to a few things: | |
6 | ||
7 | 1 - your code must follow the coding style rules | |
b706b2ee | 8 | 2 - the format of the submission must Github pull requests |
752c0602 | 9 | 3 - your work must be signed |
10 | ||
11 | ||
12 | Coding Style: | |
13 | ------------- | |
14 | ||
15 | The coding style follows the Linux kernel coding style. | |
16 | ||
17 | The coding style is defined in the 'CodingStyle' file, available in | |
18 | the directory 'Documentation' of the Linux kernel source tree. | |
19 | ||
e81c7f2c | 20 | It can be accessed online too: |
752c0602 | 21 | |
b706b2ee | 22 | https://www.kernel.org/doc/html/v4.10/process/coding-style.html |
752c0602 | 23 | |
24 | Submitting Modifications: | |
25 | ------------------------- | |
26 | ||
b706b2ee | 27 | The contributions must be Github pull requests. |
188e0ab6 SG |
28 | |
29 | Licensing for new files: | |
30 | ------------------------ | |
31 | ||
32 | LXC is made of files shipped under a few different licenses. | |
33 | ||
34 | Anything that ends up being part of the LXC library needs to be released | |
35 | under LGPLv2.1+ or a license compatible with it (though the latter will | |
36 | only be accepted for cases where the code originated elsewhere and was | |
37 | imported into LXC). | |
38 | ||
39 | Language bindings for the libraries need to be released under LGPLv2.1+. | |
40 | ||
41 | Anything else (non-libaries) needs to be Free Software and needs to be | |
42 | allowed to link with LGPLv2.1+ code (if needed). LXC upstream prefers | |
43 | LGPLv2.1+ or GPLv2 for those. | |
44 | ||
188e0ab6 SG |
45 | When introducing a new file into the project, please make sure it has a |
46 | copyright header making clear under which license it's being released | |
47 | and if it doesn't match the criteria described above, please explain | |
48 | your decision on the lxc-devel mailing-list when submitting your patch. | |
49 | ||
752c0602 | 50 | Developer Certificate of Origin: |
51 | -------------------------------- | |
52 | ||
53 | To improve tracking of contributions to this project we will use a | |
4a308d66 | 54 | process modeled on the modified DCO 1.1 and use a "sign-off" procedure. |
752c0602 | 55 | |
56 | The sign-off is a simple line at the end of the explanation for the | |
57 | patch, which certifies that you wrote it or otherwise have the right | |
58 | to pass it on as an open-source patch. The rules are pretty simple: | |
59 | if you can certify the below: | |
60 | ||
61 | By making a contribution to this project, I certify that: | |
62 | ||
63 | (a) The contribution was created in whole or in part by me and I have | |
64 | the right to submit it under the open source license indicated in | |
65 | the file; or | |
66 | ||
67 | (b) The contribution is based upon previous work that, to the best of | |
68 | my knowledge, is covered under an appropriate open source License | |
69 | and I have the right under that license to submit that work with | |
70 | modifications, whether created in whole or in part by me, under | |
71 | the same open source license (unless I am permitted to submit | |
72 | under a different license), as indicated in the file; or | |
73 | ||
74 | (c) The contribution was provided directly to me by some other person | |
75 | who certified (a), (b) or (c) and I have not modified it. | |
76 | ||
77 | (d) The contribution is made free of any other party's intellectual | |
78 | property claims or rights. | |
79 | ||
80 | (e) I understand and agree that this project and the contribution are | |
81 | public and that a record of the contribution (including all | |
82 | personal information I submit with it, including my sign-off) is | |
83 | maintained indefinitely and may be redistributed consistent with | |
84 | this project or the open source license(s) involved. | |
85 | ||
86 | ||
87 | then you just add a line saying | |
88 | ||
836676ca | 89 | Signed-off-by: Random J Developer <random@developer.org> |
752c0602 | 90 | |
99777255 NC |
91 | You can do it by using option -s or --signoff when you commit |
92 | ||
93 | git commit --signoff ... | |
94 | ||
836676ca | 95 | using your real name (sorry, no pseudonyms or anonymous contributions.) |
b706b2ee CB |
96 | |
97 | In addition we support the following DCOs which maintainers can use to indicate | |
98 | that a patch is acceptable: | |
99 | ||
100 | Acked-by: Random J Developer <random@developer.org> | |
101 | Reviewed-by: Random J Developer <random@developer.org> | |
102 | ||
103 | If you are contributing as a group who is implementing a feature together such | |
104 | that it cannot be reasonably attributed to a single developer please use: | |
105 | ||
106 | Co-developed-by: Random J Developer 1 <random_1@developer.org> | |
107 | Co-developed-by: Random J Developer 2 <random_1@developer.org> |