container-object-storage-interface-api icon indicating copy to clipboard operation
container-object-storage-interface-api copied to clipboard

Clean up gRPC spec.md

Open BlaineEXE opened this issue 1 year ago • 2 comments

A lot of the spec.md file is out of date from what is in the KEP.

Where possible, the KEP should be the source of truth, so I think a lot of information can just be deleted. For example, terminology, diagrams, objective, goals, non-goals, architecture. All these things should be defined by the KEP.

There are also some old things present which are no longer in the COSI KEP like AnonymousBucketAccessMode. These items probably should be removed from the spec, but they can be captured as a feature request to plan/design in the KEP in the future.

There are also areas where the spec just seems out of date with what is in the KEP. While I generally expect that the spec in code may have some minor details and bug fixes defined that aren't in the KEP, we should strive to keep things consistent.

A good time to clean up the spec.md is probably when we are updating it to be in line with the in-progress v1alpha2 design doc.

BlaineEXE avatar Jul 18 '24 18:07 BlaineEXE

The Kubernetes project currently lacks enough contributors to adequately respond to all issues.

This bot triages un-triaged issues according to the following rules:

  • After 90d of inactivity, lifecycle/stale is applied
  • After 30d of inactivity since lifecycle/stale was applied, lifecycle/rotten is applied
  • After 30d of inactivity since lifecycle/rotten was applied, the issue is closed

You can:

  • Mark this issue as fresh with /remove-lifecycle stale
  • Close this issue with /close
  • Offer to help out with Issue Triage

Please send feedback to sig-contributor-experience at kubernetes/community.

/lifecycle stale

k8s-triage-robot avatar Oct 16 '24 19:10 k8s-triage-robot

/remove-lifecycle stale

BlaineEXE avatar Oct 22 '24 18:10 BlaineEXE