-
Notifications
You must be signed in to change notification settings - Fork 27
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add governance and releases docs #15
Add governance and releases docs #15
Commits on Jun 29, 2016
-
proposals: add release-approval-process
This is a proposed process for approval of new releases of specifications and projects from the OCI. The creation of this process is designed to clarify how a release gets created and who needs to sign off.
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for 593b8f0 - Browse repository at this point
Copy the full SHA 593b8f0View commit details -
proposal: release-approval-process add some motivation
I got some feedback from folks that some motivation early in the document might be helpful for why the process encourages regular communication.
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for 889639a - Browse repository at this point
Copy the full SHA 889639aView commit details -
proposals: release approval process to one week for apps
Requiring applications wait 1 week to get feedback before making a release, removing "business day" wording @cyphar, @stevvooe, and @wking were in the discussion.[1] [1] opencontainers/tob#15 (comment)
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for 7e11601 - Browse repository at this point
Copy the full SHA 7e11601View commit details -
proposals: release approval process 3 rcs required
Requiring the _minimum_ process for a major release to be 3 rcs and a final release. This will establish a _minimum_ timeline of 1 month to get to a release assuming zero required changes. @stevvooe, @wking were in this discussion. opencontainers/tob#15 (comment)
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for e48c6c7 - Browse repository at this point
Copy the full SHA e48c6c7View commit details -
proposals: release approval process: one month pre-releases
Changing the release goal for projects to a "SHOULD monthly release" from the original bi-weekly. @diogomonica, @stevvooe, @mrunalp, @RobDolinMS were in that discussion opencontainers/tob#15 (comment)
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for 445ee2d - Browse repository at this point
Copy the full SHA 445ee2dView commit details -
proposals: release approval process: use consistent language for rejects
Fix up the language around REJECTs so it is easier to understand. The basic premise is that a release may continue with REJECTs if 2/3 of the maintainers vote to make the release. But, the maintainers SHOULD discuss and allow time for any REJECTs to become LGTMs. Spread over two discussions: [1](https://github.com/opencontainers/tob/pull/15/files/bdfa70d70f093146bc730be2576586ec8ed57cca#r66519789) and [2](https://github.com/opencontainers/tob/pull/15/files/bdfa70d70f093146bc730be2576586ec8ed57cca#r66668148)
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for f629094 - Browse repository at this point
Copy the full SHA f629094View commit details -
proposals: release approval process: clarify utility of GitHub
Based on discussion with @wking and @stevvooe https://github.com/opencontainers/tob/pull/15/files/bdfa70d70f093146bc730be2576586ec8ed57cca#r66543381
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for c15c0e2 - Browse repository at this point
Copy the full SHA c15c0e2View commit details -
proposals: release-approval-process: add voting members language
The intention of the voting members language is to ensure that releases can proceed even if people are unresponsive, on vacation, etc without ambiguity. This is similar to how the TOB operates. Identified by @wking here: opencontainers/tob#15 (comment)
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for 3fd90e8 - Browse repository at this point
Copy the full SHA 3fd90e8View commit details -
proposals: release approval process: add quorum language
Based on discussion with wking and mrunalp participating and Stephen Day acking in IRC: opencontainers/tob#15 (comment)
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for 267f916 - Browse repository at this point
Copy the full SHA 267f916View commit details -
proposals: release approval process: add language about mailing list
This addresses @stevvooe's concern about GitHub issues being the only medium for discussion of a reject. @wking and @philips were involved in this discussion: opencontainers/tob#15 (comment)
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for eecc4fe - Browse repository at this point
Copy the full SHA eecc4feView commit details -
proposals: release approval process: add information to projects
Projects have a happy path and a slow path. The happy path is a release with maintainers agreeing and a timeout. The slow path has rejects and quorums. Based on discussion with @wking opencontainers/tob#15 (comment)
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for f2148b6 - Browse repository at this point
Copy the full SHA f2148b6View commit details -
proposals: release approval process: improve REJECT feedback
Instead of being prescriptive provide suggestions instead for how to provide release REJECTS feedback. Based on feedback from Stephen Day and @wking.
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for 89afeeb - Browse repository at this point
Copy the full SHA 89afeebView commit details -
proposals: release-approval-process: fixup additional typos
Fixup qourum typos based on feedback from @wking.
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for 775db84 - Browse repository at this point
Copy the full SHA 775db84View commit details -
release-approval: Shuffle to make more DRY
Avoid duplication by collecting common ideas (e.g. list-based voting) in their own sections. After this reshuffling, it became apparent that there were no special application restrictions, so I added additional language to motivate the specification-specific additions. Signed-off-by: W. Trevor King <[email protected]>
Configuration menu - View commit details
-
Copy full SHA for 40966cf - Browse repository at this point
Copy the full SHA 40966cfView commit details -
release-approval: Add non-spec unanimous quorum reduction
philips/tob#1 (comment) Signed-off-by: W. Trevor King <[email protected]>
Configuration menu - View commit details
-
Copy full SHA for c340e73 - Browse repository at this point
Copy the full SHA c340e73View commit details -
proposals: release-approval-process fix a grammar thing
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for af1013d - Browse repository at this point
Copy the full SHA af1013dView commit details -
Reported by Tianon opencontainers/tob#15 (comment)
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for be10456 - Browse repository at this point
Copy the full SHA be10456View commit details -
proposals: release approval process explain security@ email
Expand a bit more information about the security@ alias and who is involved in a security sensitive release.
Brandon Philips committedJun 29, 2016 Configuration menu - View commit details
-
Copy full SHA for 86b3087 - Browse repository at this point
Copy the full SHA 86b3087View commit details
Commits on Jul 12, 2016
-
project-governance: Make voting more generic
This is useful for more than release approval. For example, it's useful for updating the project governance document itself [1]. I've also tried to address Jason's other points, except for defining a "breaking change" (since that is tied up in [2]). New wording about motions and whatnot is pulled from Roberts' [3], see proposing a motion (RRoO I.4, p33) and seconding a motion (RRoO I.5, p36). The subject templates I just made up on my own after thinking over the initial proposal emails (e.g. [4]). I also pulled in the one-sentence pattern [5] since I was touching so much. [1]: https://groups.google.com/a/opencontainers.org/d/msg/dev/ik3MIDWq4Us/Zx1JUStXBAAJ Subject: Re: Vote Required: OCI Image Spec Release Process Date: Fri, 24 Jun 2016 16:58:58 -0700 Message-ID: <CAFi6z1HAkKbnMoAXubyGusQJ_MromgpQ4qHCQ3R9_NwZNYBX5w@mail.gmail.com> [2]: opencontainers/tob#16 [3]: http://archive.org/details/Robertsrulesofor00robe_201303 [4]: https://groups.google.com/a/opencontainers.org/forum/#!topic/dev/ik3MIDWq4Us Subject: Vote Required: OCI Image Spec Release Process Date: Thu, 23 Jun 2016 15:56:40 +0000 Message-ID: <CAD2oYtNnW+hP7Q3NPBdYHOKfigU0pvbgcphKPhRB=ZfQBwX8VA@mail.gmail.com> [5]: opencontainers/tob#15 (comment) Signed-off-by: W. Trevor King <[email protected]>
Configuration menu - View commit details
-
Copy full SHA for c732cc2 - Browse repository at this point
Copy the full SHA c732cc2View commit details -
GOVERNANCE and RELEASES: split the files
Split files into governance and releases and outline the maintainers of the GOVERNANCE doc itself. Signed-off-by: Brandon Philips <[email protected]>
Brandon Philips committedJul 12, 2016 Configuration menu - View commit details
-
Copy full SHA for 56abe12 - Browse repository at this point
Copy the full SHA 56abe12View commit details