SIP-000-1: SIP Process SIP-000 Upgrade#241
Conversation
… sips/sip-000/replaced SIPs/sip-000-stacks-improvement-proposal-process.md
…eplaced SIPs/readme.md
…ip-000replaced SIP.readme.md
…rovement-proposal-process.md
…1-stacks-improvement-proposal-process.md
…ks-improvement-proposal-process.md
…1-stacks-improvement-proposal-process.md
…ks-improvement-proposal-process.md
…-stacks-improvement-proposal-process.md
… sip-000-1-stacks-improvement-proposal-process.md
…ks-improvement-proposal-process.md
1. Update Abstract to mention this replaces SIP-000 and the rationale 2. Added “## Backwards Compatibility” but it is NA 3. Moved 2 ## SIP Flow subsections together, renamed the first to SIP Status 4. Moved “## SIP Types” to logical order, after “## Layer” 5. New subsection “## SIP Layers” created by moving the explanations from Preambles 6. Preambles’ spec’s ordering of fields reordered to match the SIP_TEMPLATE 7. Added “### SIP Authoring Rules” 8. Added “### Expectation of Minimum Timelines And Rules” 9. Added “### SIP Versioning and Replacement Update Policy” 10. Added “### Documentation, Repo Maintancne, Merging into Main” Unanswered questions requiring agreeing upon: ### Hard Fork SIPs - Define process for code freeze and creation of dedicated release branches. - Only milestone changes for that release may be merged into the fork branch.
|
Added "### Post-CAB Vote Updates" details cc: @whoabuddy |
|
thanks for this! looking it over |
|
Moving to draft for now |
|
As much lots of technical people can directly submit SIP proposal to SIP Repo directly and get feedback that way
Taking transparency and public feedback period needed in general, I'd actually suggest considering ensuring all SIP authors go through a defined process (which can be reinforced by showing it on ZeroAuthority platform)
SIP Editors (mid-process) and SIP Deputies (earlier process) will assist the Authors throughout the process. |
Thanks @Hero-Gamer So as @wileyj said, only 4-6 are enforceable and 1-3 are suggested, especially for getting community engagement. |
|
Thanks Hero-Gamer for the work here, I know you talked to a lot of people to get to this list and several items are worth keeping. But not in SIP-000, let me explain. This PR started from the question in #228: how do we update a ratified SIP, including SIP-000 itself. SIP-000 already answers that. It has the Replaced status, the Replaces and Superseded-By preamble fields, and it says substantial changes to a ratified SIP must be done as a separate SIP. A process update is a Meta type SIP under the Governance consideration and it gets the next free number like any other SIP. That is also exactly the BIP2 to BIP3 precedent you confirmed with the BIP editor in #228. So we do not need to change SIP-000 to be able to update SIP-000, and we do not need a SIP-000-1 numbering scheme. On the content: items 1 to 7 of the changelog are reordering and moving text, no change in meaning, not worth a ratification cycle. The fork-only rule, comment resolution etiquette and merge checklist are useful but they are repo working rules, they belong in a CONTRIBUTING or process doc where we can improve them without a vote. The merge checklist as written also conflicts with SIP-000, which requires Accepted SIPs to be committed to the repo before CAB review. The post CAB vote rule is good practice and CABs can adopt it in their own bylaws today. The minimum 6 week timeline I am against, SIP-000 deliberately says fair, speedy, timely, some SIPs need six months and some need two weeks, and an undefined emergency exception undoes the rule exactly when it matters. Hard fork release branches are engineering process, SIP-000 explicitly keeps ratification independent of that, this belongs in stacks-core release management. Next steps:
|
We could implement process updates to make transparency and public feedback period needed - it would also help people understand current status |
SIP-000-1 packs a number of refinement of the SIP Process we've learned over the past few years.
Below is a "Change log" of SIP-000-1
So please welcome to make changes and add/remove suggestions!
Some unanswered questions:
Hard Fork SIPs code freeze rules - Define process for code freeze and creation of dedicated release branches. - Only milestone changes for that release may be merged into the fork branch.
SIP-000 folder naming: I tried both folder naming ideas, whether it's "_1" or "-1" (see images below), might look both little odd and confusing, I'd actually perhaps propose keeping the SIP-000 folder naming as is. Only the the MD files get updated according to the SIP-000 versioning policy, and filed correctly within.
Rider SIPs rules of engagement: How Rider SIPs should be handled approval wise. And documentation wise.