Skip to content

Commit 7e4a877

Browse files
committed
Merge pull request opencontainers#104 from vbatts/contribution-updates
README.md: contribution about discussion
2 parents da9240a + 7e22d0d commit 7e4a877

File tree

1 file changed

+20
-7
lines changed

1 file changed

+20
-7
lines changed

README.md

Lines changed: 20 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -54,21 +54,34 @@ With Standard Containers we can put an end to that embarrassment, by making INDU
5454

5555
# Contributing
5656

57-
Development happens on github for the spec. Issues are used for bugs and actionable items and longer
58-
discussions can happen on the mailing list. You can subscribe and join the mailing list on
59-
[google groups](https://groups.google.com/a/opencontainers.org/forum/#!forum/dev).
57+
Development happens on GitHub for the spec.
58+
Issues are used for bugs and actionable items and longer discussions can happen on the [mailing list](#mailing-list).
6059

61-
The specification and code is licensed under the Apache 2.0 license found in
62-
the `LICENSE` file of this repository.
60+
The specification and code is licensed under the Apache 2.0 license found in the `LICENSE` file of this repository.
61+
62+
## Discuss your design
63+
64+
The project welcomes submissions, but please let everyone know what you are working on.
65+
66+
Before undertaking a nontrivial change to this specification, send mail to the [mailing list](#mailing-list) to discuss what you plan to do.
67+
This gives everyone a chance to validate the design, helps prevent duplication of effort, and ensures that the idea fits.
68+
It also guarantees that the design is sound before code is written; a GitHub pull-request is not the place for high-level discussions.
69+
70+
Typos and grammatical errors can go straight to a pull-request.
71+
When in doubt, start on the [mailing-list](#mailing-list).
6372

6473
## Weekly Call
6574

6675
The contributors and maintainers of the project have a weekly meeting Wednesdays at 10:00 AM PST.
6776
The link to the call will be posted on the mailing list each week along with set topics for discussion.
6877
Everyone is welcome to participate in the call, although there can only be speaking members on the Google Hangout.
6978
Participants who don't get a speaking slot can watch the live broadcast on [this YouTube channel][youtube] and post feedback and questions on [the IRC channel](#irc).
70-
Everyone is welcome to propose additional topics, suggest other agenda alterations, or request a speaking slot via the mailing list.
71-
Minutes for the call will be posted to the mailing list for those who are unable to join the call.
79+
Everyone is welcome to propose additional topics, suggest other agenda alterations, or request a speaking slot via the [mailing list](#mailing-list).
80+
Minutes for the call will be posted to the [mailing list](#mailing-list) for those who are unable to join the call.
81+
82+
## Mailing List
83+
84+
You can subscribe and join the mailing list on [Google Groups](https://groups.google.com/a/opencontainers.org/forum/#!forum/dev).
7285

7386
## IRC
7487

0 commit comments

Comments
 (0)