stacksgov / sips

Community-submitted Stacks Improvement Proposals (SIPs)
132 stars 80 forks source link

Documenting the SIP approval process #145

Open whoabuddy opened 1 year ago

whoabuddy commented 1 year ago

Now that we have more and more people looking at SIPs, we need a consistent workflow that's easy to use but adheres to SIP-000.

Since GitHub is the main medium we're using for the SIPs, I propose the following approach:

  1. New SIP is created in Draft status via a PR
  2. Once ready, request review from SIP Editors, who have at least one person with access to this GitHub repo that can be tagged (s/o to @rafaelcr)
  3. SIP Editors will provide feedback until SIP is ready, then review/approve the PR, then make a commit to the PR adding their sign-off and updating the status to Accepted
  4. Request reviews from relevant CABs, who also have at least one person with access (gov: @whoabuddy, tech: @obycode)
  5. CAB will provide feedback and add minutes in a separate PR, then if approved, review/approve the PR, and add their sign-off. Last CAB to add sign-off also updates status to Recommended
  6. Request review from Steering Committee (likely @jcnelson) and they can review/approve the PR, add their sign-off (is there a spot for this?), and update status to Activation-in-Progress and the README.

At that point we should probably merge it as it would update the README on the main branch, which shows both activation-in-progress and ratified SIPs.

Then a separate PR could be created (by SC, or maybe by others in the groups above) that changes the status to Ratified and updates the README once it's finalized.

Another way to look at this:

Curious if others have thoughts on this, the SIPs below have parts of the process in place, and once we settle on a structure we can document it either through a SIP, somewhere in this repo as a doc, or both.