specs icon indicating copy to clipboard operation
specs copied to clipboard

Repo and process cleanup (Launchpad cohort v5 edition)

Open BigLep opened this issue 1 year ago • 3 comments

Background

Some Launchpad v5 members want to do spec cleanup. Below is an attempt to capture some of the current problems they could help solve.

This should likely be broken into multiple discreet issues that can be actioned/completed independently. I'm creating a issue right now to capture problems/ideas, and then we can break this down.

Problems to solve

  1. General issue cleanup. We have 80 open issues in the repo. Many are years old. We should go through them and for any that are still relevant we set a priority, size, and next steps.
  2. We're missing a summarized view of the specs with extra metadata about them. For example, https://github.com/ipfs/specs/blob/main/README.md gives a list but it would be nice to see in a table form extra metadata like:
  • Spec status
  • Associated IPIPs
  • When last updated
  • Which implementations implement which specs (or at least have a way for this to be captured)
  • Which issues are open about the spec
  1. IPIPs are the way to make changes to a spec. We don't have a clear way to see what IPIPs are in progress, who is committed to looking at them, when they were last updated, whose court the ball is in.
  2. No reporting out on what happened in the specs repo the last week/month (new IPIPs, which IPIPs were commented on, which IPIPs landed or which specs got updates).
  3. The specs aren't exposed with the rest of our IPFS documentation at docs.ipfs.tech. It would be ideal to have a way to slurp them over and present them there, at least the summary/table view.

BigLep avatar Aug 31 '22 23:08 BigLep