KEP Overview

[ANeumann82]

What this PR does / why we need it:

As a new member to the project, I had/have a hard time getting an overview of work in progress, proposals, etc. defined in KEPs.

I think an overview in the KEP folder would help a lot to make them more accessible.

It might even be a good idea having different sections here, i.e.

• Organizational
• Implemented and Done
• Future Features

[alenkacz]

I am not saying no, I just wonder what is the advantage of this to this? https://github.com/kudobuilder/kudo/tree/master/keps - is it just that the names of the files are not descriptive enough? I am just looking for a solution that would solve the problem but does not introduce another place where we need to list all keps (and might forget)

[ANeumann82]

@alenkacz Yes, there are a couple points:

1. I don't think the names of the files are (descriptive) enough.
2. We have different types of KEP, I can think of at least "dev process", "future features" and "implemented and done". Having to look through all of them keeps getting harder, especially if we get into > 50 KEPs or so
3. At the moment, it's kind of hard to get an overview what's there, in what state is it, etc.

And yes, I agree, having an additional file that needs to be updated isn't the best solution. It might work for now, and I don't think it has to be in sync all the time.

Alternatives would be:

• Add some additional metadata to the KEPs itself (One-Line-Summary, Category) and write some tooling that autogenerates the README.md (or generate it in the www-project?). It still would need to be run either manually, or whenever something in the keps-folder changes. (Could that be done with github actions)?

[nfnt]

This is great! Though, this should be automated at some point. The metadata you mention is already there, e.g. kep-number, title and status. I'm okay with writing this manually for now.

[ANeumann82]

I've added a script to generate it, and added a "short-desc" field to the metadata for each KEP, as I think the title alone isn't expressive enough.

[alenkacz]

Could you please add information about the script to the keps/readme.md? Otherwise LGTM

[nfnt]

🚢