cardano-foundation / CIPs

Cardano Improvement Proposals (CIPs)
https://cips.cardano.org/
Creative Commons Attribution 4.0 International
471 stars 317 forks source link

Indexing CIPs Repo for Core `Waiting for Implementation` proposals #863

Open Ryun1 opened 1 month ago

Ryun1 commented 1 month ago

Motivation

Solution - How can we improve this?

Maybe we maintain a Waiting for core implementation list somewhere?

What are other's thoughts?

rphair commented 1 month ago

How about storing community-oriented metadata in git notes: https://git-scm.com/docs/git-notes ?

Example of usage here: https://stackoverflow.com/questions/5959622/how-to-tag-a-single-file-in-git/5960171#5960171)

I'm new with notes but it seems they apply to commit hashes: so I guess a GitHub CI upon PR merge would loop backwards from the latest hash to find the most recent "implementation status" attached to the README.md file.

This note could therefore be done by anyone with write permission to the branch... so editors could add them in ordinary cases — and while we couldn't for organisational repositories, those organisations would likely be interested in keeping the community posted about contingencies for their implementations, and so would enthusiastically provide those notes themselves (?).

If necessary these "notes" could also be in a standard YAML format if a complex scheme of metadata were required, and then a warning could be issued a la https://github.com/cardano-foundation/CIPs/pull/837 if it failed a validation check. The output of that validating script of course would then also produce the index of "implementation status" as a file in the repository.

I'm just investigating this now so don't know if notes not showing for any of our files in the UI is because they don't have any notes yet or because notes aren't included in GitHub UI. I only know they were really unfriendly about including them in GitHub Desktop: https://github.com/desktop/desktop/issues/14755#issuecomment-1233859748

cc @lehins @WhatisRT @zliu41 @colll78 @klntsky @MicroProofs