Skip to content

Add CoIP-1 describing the CoIP process#25

Draft
kmillikin wants to merge 17 commits intomainfrom
kmillikin/coip
Draft

Add CoIP-1 describing the CoIP process#25
kmillikin wants to merge 17 commits intomainfrom
kmillikin/coip

Conversation

@kmillikin
Copy link
Copy Markdown
Contributor

@kmillikin kmillikin commented Jan 21, 2026

The CoIP process is started as a fork of the MIP (Midnight Improvement Proposal) process.

We will subsequently rename and update the document to refer to CoIP, so it's easier to track changes to it.

Signed-off-by: Kevin Millikin <kevin.millikin@shielded.io>
Signed-off-by: Kevin Millikin <kevin.millikin@shielded.io>
@github-actions
Copy link
Copy Markdown

github-actions bot commented Jan 21, 2026

Plugin Test Results

0 tests   0 ✅  0s ⏱️
0 suites  0 💤
0 files    0 ❌

Results for commit 27d2a14.

♻️ This comment has been updated with latest results.

@kmillikin kmillikin requested review from a team as code owners January 21, 2026 20:07
Signed-off-by: Kevin Millikin <kevin.millikin@shielded.io>
@github-actions
Copy link
Copy Markdown

github-actions bot commented Jan 21, 2026

Compactc E2E Tests Results

2 706 tests   2 706 ✅  5m 30s ⏱️
    1 suites      0 💤
    1 files        0 ❌

Results for commit 27d2a14.

♻️ This comment has been updated with latest results.

@github-actions
Copy link
Copy Markdown

E2E test results

build: Run #70

Tests 📝 Passed ✅ Failed ❌ Skipped ⏭️ Pending ⏳ Other ❓ Flaky 🍂 Duration ⏱️
453 447 0 6 0 0 0 55.9s

🎉 All tests passed!

Github Test Reporter

@github-actions
Copy link
Copy Markdown

github-actions bot commented Jan 21, 2026

Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚


Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚


Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚


Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚


Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚


Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚


Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚


Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚


Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚


Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚


Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚


Flaky Rate

Overall Flakiness 0.00%    ±0

No current tests have flaky rates to display ✨

Github Test Reporter by CTRF 💚

@kmillikin
Copy link
Copy Markdown
Contributor Author

General discussion can go in issue #26.

Signed-off-by: Kevin Millikin <kevin.millikin@shielded.io>
Signed-off-by: Kevin Millikin <kevin.millikin@shielded.io>
@github-actions
Copy link
Copy Markdown

E2E test results

build: Run #72

Tests 📝 Passed ✅ Failed ❌ Skipped ⏭️ Pending ⏳ Other ❓ Flaky 🍂 Duration ⏱️
453 447 0 6 0 0 0 56.6s

🎉 All tests passed!

Github Test Reporter

Signed-off-by: Kevin Millikin <kevin.millikin@shielded.io>
@github-actions
Copy link
Copy Markdown

E2E test results

build: Run #137

Tests 📝 Passed ✅ Failed ❌ Skipped ⏭️ Pending ⏳ Other ❓ Flaky 🍂 Duration ⏱️
453 447 0 6 0 0 0 58.1s

🎉 All tests passed!

Github Test Reporter

Signed-off-by: Kevin Millikin <kevin.millikin@shielded.io>
@github-actions
Copy link
Copy Markdown

E2E test results

build: Run #138

Tests 📝 Passed ✅ Failed ❌ Skipped ⏭️ Pending ⏳ Other ❓ Flaky 🍂 Duration ⏱️
453 447 0 6 0 0 0 56.7s

🎉 All tests passed!

Github Test Reporter

Signed-off-by: Kevin Millikin <kevin.millikin@shielded.io>
@github-actions
Copy link
Copy Markdown

E2E test results

build: Run #139

Tests 📝 Passed ✅ Failed ❌ Skipped ⏭️ Pending ⏳ Other ❓ Flaky 🍂 Duration ⏱️
453 447 0 6 0 0 0 56.8s

🎉 All tests passed!

Github Test Reporter

Signed-off-by: Kevin Millikin <kevin.millikin@shielded.io>
@github-actions
Copy link
Copy Markdown

E2E test results

build: Run #142

Tests 📝 Passed ✅ Failed ❌ Skipped ⏭️ Pending ⏳ Other ❓ Flaky 🍂 Duration ⏱️
453 447 0 6 0 0 0 55.8s

🎉 All tests passed!

Github Test Reporter

Signed-off-by: Kevin Millikin <kevin.millikin@shielded.io>
@github-actions
Copy link
Copy Markdown

E2E test results

build: Run #143

Tests 📝 Passed ✅ Failed ❌ Skipped ⏭️ Pending ⏳ Other ❓ Flaky 🍂 Duration ⏱️
453 447 0 6 0 0 0 56.1s

🎉 All tests passed!

Github Test Reporter

@github-actions
Copy link
Copy Markdown

E2E test results

build: Run #179

Tests 📝 Passed ✅ Failed ❌ Skipped ⏭️ Pending ⏳ Other ❓ Flaky 🍂 Duration ⏱️
452 446 0 6 0 0 0 57.3s

🎉 All tests passed!

Github Test Reporter

@JosephDenman
Copy link
Copy Markdown
Contributor

Heads up Kevin, the changes in this PR are now also in #48. You need to sign one of your commits before this can be merged. Otherwise, would have merged it before adding the changes in my unrelated PR.

@kmillikin
Copy link
Copy Markdown
Contributor Author

This is not read to merge, it is still being worked on and it has no feedback from reviewers.

I will change the status to draft to make that clear.

@kmillikin kmillikin marked this pull request as draft January 29, 2026 15:01
This reverts commit 8ee9649.

It will be submitted as a separate PR.
@github-actions
Copy link
Copy Markdown

github-actions bot commented Feb 3, 2026

E2E test results

build: Run #208

Tests 📝 Passed ✅ Failed ❌ Skipped ⏭️ Pending ⏳ Other ❓ Flaky 🍂 Duration ⏱️
458 452 0 6 0 0 0 57.1s

🎉 All tests passed!

Github Test Reporter

This is a document that follows the template structure below.
The CoIP document is added to the `coips` subdirectory with the name `coip-XXXX.md` (those are literal `X`s).
The status of the CoIP is set to **Draft** and a pull request (PR) is made to add the draft document.
1. **TSC approval of the draft:** The TSC approves merging the draft CoIP PR.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. **TSC approval of the draft:** The TSC approves merging the draft CoIP PR.
2. **TSC approval of the draft:** The TSC approves merging the draft CoIP PR.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So by the end of step 2, we expect the PR to be merged and the status of the CoIP is approved?

Copy link
Copy Markdown
Contributor

@pataei pataei Feb 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's unclear from what follows that who is responsible to change the status of the CoIP as it evolves, i.e., draft --> submitted --> accepted/rejected --> implemented --> released. It is also unclear if we require a separate PR for each of these or if accepted/rejected --> implemented happens with the implementation PR and implemented --> released with the cut PR.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • GitHub's markdown renderer (as well as Slack, Stack Overflow, etc. and probably most other ones?) will number lists for you if they all start with a number, and so the numbers don't matter, they can even be out of order. (The implementation is to produce an <ol> for the list with a <li> for each item and then HTML numbers them automatically. The numbers never appear after processing the markdown.) I like to use 1. for all of them to make it easier to insert, remove, and potentially reorder items.

  • This is step 3. By the end of step 3 the CoIP is merged to the repository. The status is "draft". This is so it can be worked on directly with PRs from multiple authors and history tracked in the repository rather than on a single long-running PR. I've seen proposals take six months or a year to get into a form where they can be accepted, and PRs to have hundreds of comments and get very difficult to follow. People also want to see WIP directly in the repository in the numbered file rather than having to search for the PR that has the WIP.

  • I did try to be very explicit in each step about what action was performed and who was performing it. I will ensure it's clear. TSC themselves or some maintainer will update CoIP statuses, authors don't need to send us PRs to do that for us.

Note that this is **not** the same as acceptance of the CoIP.
The TSC will vote to merge the draft CoIP PR at their next regularly scheduled meeting.
They will ensure that the document is correctly formatted, that is it clear and understandable, and that it is well motivated.
The TSC will be generally lenient at this stage with the understanding that problems can be addressed before the CoIP is submitted.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The TSC will be generally lenient at this stage with the understanding that problems can be addressed before the CoIP is submitted.
The TSC will be generally lenient at this stage with the understanding that problems can't be addressed before the CoIP is submitted.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will be more clear about the various kinds of submission. Problems can be addressed before final submission for yes/no vote, they do not need to be in the initial draft to get a number assigned.

- Teams responsible for development
- Testing and audit milestones

### CoIP Template
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It might be more straightforward to have the template as a separate file under coips/coip-template.md.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, that is the remaining task. It doesn't belong here.

kmillikin and others added 4 commits February 24, 2026 08:47
Co-authored-by: Parisa Ataei <paris.ataei@gmail.com>
Signed-off-by: Kevin Millikin <kmillikin@gmail.com>
Signed-off-by: Kevin Millikin <kevin.millikin@shielded.io>
@0xisk
Copy link
Copy Markdown

0xisk commented Mar 20, 2026

@kmillikin wondering what is the status here? as we are thinking to create a CoIP.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants