Skip to content
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

Merged

Commits on Jun 29, 2016

  1. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    593b8f0 View commit details
    Browse the repository at this point in the history
  2. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    889639a View commit details
    Browse the repository at this point in the history
  3. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    7e11601 View commit details
    Browse the repository at this point in the history
  4. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    e48c6c7 View commit details
    Browse the repository at this point in the history
  5. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    445ee2d View commit details
    Browse the repository at this point in the history
  6. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    f629094 View commit details
    Browse the repository at this point in the history
  7. Configuration menu
    Copy the full SHA
    c15c0e2 View commit details
    Browse the repository at this point in the history
  8. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    3fd90e8 View commit details
    Browse the repository at this point in the history
  9. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    267f916 View commit details
    Browse the repository at this point in the history
  10. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    eecc4fe View commit details
    Browse the repository at this point in the history
  11. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    f2148b6 View commit details
    Browse the repository at this point in the history
  12. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    89afeeb View commit details
    Browse the repository at this point in the history
  13. proposals: release-approval-process: fixup additional typos

    Fixup qourum typos based on feedback from @wking.
    Brandon Philips committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    775db84 View commit details
    Browse the repository at this point in the history
  14. 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]>
    wking authored and Brandon Philips committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    40966cf View commit details
    Browse the repository at this point in the history
  15. release-approval: Add non-spec unanimous quorum reduction

    philips/tob#1 (comment)
    
    Signed-off-by: W. Trevor King <[email protected]>
    wking authored and Brandon Philips committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    c340e73 View commit details
    Browse the repository at this point in the history
  16. proposals: release-approval-process fix a grammar thing

    Brandon Philips committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    af1013d View commit details
    Browse the repository at this point in the history
  17. proposal: fix a typo

    Brandon Philips committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    be10456 View commit details
    Browse the repository at this point in the history
  18. 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 committed Jun 29, 2016
    Configuration menu
    Copy the full SHA
    86b3087 View commit details
    Browse the repository at this point in the history

Commits on Jul 12, 2016

  1. 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]>
    wking authored and Brandon Philips committed Jul 12, 2016
    Configuration menu
    Copy the full SHA
    c732cc2 View commit details
    Browse the repository at this point in the history
  2. 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 committed Jul 12, 2016
    Configuration menu
    Copy the full SHA
    56abe12 View commit details
    Browse the repository at this point in the history