|
1 | 1 | # Contribution Guidelines |
2 | 2 |
|
| 3 | +Development happens on GitHub. |
| 4 | +Issues are used for bugs and actionable items and longer discussions can happen on the [mailing list](#mailing-list). |
| 5 | + |
| 6 | +The content of this repository is licensed under the [Apache License, Version 2.0](LICENSE). |
| 7 | + |
| 8 | +## Code of Conduct |
| 9 | + |
| 10 | +Participation in the Open Container community is governed by [Open Container Code of Conduct][code-of-conduct]. |
| 11 | + |
| 12 | +## Weekly Call |
| 13 | + |
| 14 | +The contributors and maintainers of all OCI projects have a weekly meeting Wednesdays at 2:00 PM (USA Pacific). |
| 15 | +Everyone is welcome to participate via [UberConference web][UberConference] or audio-only: 415-968-0849 (no PIN needed). |
| 16 | +An initial agenda will be posted to the [mailing list](#mailing-list) earlier in the week, and everyone is welcome to propose additional topics or suggest other agenda alterations there. |
| 17 | +Minutes are posted to the [mailing list](#mailing-list) and minutes from past calls are [archived][meeting-archives]. |
| 18 | + |
| 19 | +## Mailing list |
| 20 | + |
| 21 | +You can subscribe and browse the mailing list on [Google Groups][mailing-list]. |
| 22 | + |
| 23 | +## IRC |
| 24 | + |
| 25 | +OCI discussion happens on #opencontainers on [Freenode][] ([logs][irc-logs]). |
| 26 | + |
3 | 27 | ## Git |
4 | 28 |
|
5 | 29 | ### Security issues |
@@ -27,7 +51,7 @@ incorporating a new feature. |
27 | 51 |
|
28 | 52 | Fork the repo and make changes on your fork in a feature branch. |
29 | 53 | For larger bugs and enhancements, consider filing a leader issue or mailing-list thread for discussion that is independent of the implementation. |
30 | | -Small changes or changes that have been discussed on the project mailing list may be submitted without a leader issue. |
| 54 | +Small changes or changes that have been discussed on the [project mailing list](#mailing-list) may be submitted without a leader issue. |
31 | 55 |
|
32 | 56 | If the project has a test suite, submit unit tests for your changes. Take a |
33 | 57 | look at existing tests for inspiration. Run the full test suite on your branch |
@@ -69,8 +93,7 @@ or `Fixes #XXX`, which will automatically close the issue when merged. |
69 | 93 | The sign-off is a simple line at the end of the explanation for the |
70 | 94 | patch, which certifies that you wrote it or otherwise have the right to |
71 | 95 | pass it on as an open-source patch. The rules are pretty simple: if you |
72 | | -can certify the below (from |
73 | | -[developercertificate.org](http://developercertificate.org/)): |
| 96 | +can certify the below (from [developercertificate.org][]): |
74 | 97 |
|
75 | 98 | ``` |
76 | 99 | Developer Certificate of Origin |
@@ -119,3 +142,11 @@ then you just add a line to every git commit message: |
119 | 142 | using your real name (sorry, no pseudonyms or anonymous contributions.) |
120 | 143 |
|
121 | 144 | You can add the sign off when creating the git commit via `git commit -s`. |
| 145 | + |
| 146 | +[code-of-conduct]: https://github.com/opencontainers/tob/blob/d2f9d68c1332870e40693fe077d311e0742bc73d/code-of-conduct.md |
| 147 | +[developercertificate.org]: http://developercertificate.org/ |
| 148 | +[Freenode]: https://freenode.net/ |
| 149 | +[irc-logs]: http://ircbot.wl.linuxfoundation.org/eavesdrop/%23opencontainers/ |
| 150 | +[mailing-list]: https://groups.google.com/a/opencontainers.org/forum/#!forum/dev |
| 151 | +[meeting-archives]: http://ircbot.wl.linuxfoundation.org/meetings/opencontainers/ |
| 152 | +[UberConference]: https://www.uberconference.com/opencontainers |
0 commit comments