Define Enhancement Process

[stevendborrelli]

Overview

Define a enhancement process so that changes to the specification and design decisions are are shared and reviewed by the community. As COSI is early in the development cycle, the process should be lightweight but also be able to document the motivation behind design decisions.

Examples

• Kubernetes Enhancement Process
• Python Enhancement Proposal
• RFC-7322 The RFC Style Guide
• Rust RFCs

[stevendborrelli]

A proposal to track early-stage COSI development.

1. All Enhancement Requests for Comments (RFCs) are started via github issues in the cosi-project/enhancements repository.
2. Format of the issue is detailed below. We can make this an issue template in the repo.
3. COSI community provides comments on the issue and up/down issue are tallied.
4. At weekly community meeting (or more frequently), status of open RFCs are reviewed.
5. When RFC is accepted, the markdown file for the enhancement will be stored under the rfcs/ directory of this repository.

--
Title: Enhancement Template
Name: Author Name
Date: YYYY-MM-DD

Summary

Brief overview of the enhancement.

Motivation

Why are you proposing this change? Provide background, including other ideas considered.

Proposal

A description of the proposal, including code example and/or architectural diagrams.

Examples

Provide code examples of how the enhancement would be used.

References/Prior Art

Provide any reference links or prior art that inspired this RFC.

[souleb]

We should add something concerning the status of an enhancement. Something like

• proposed
• implementable
• implemented

And also maybe maintain a list of the enhancement. I have seen that being done directly in the readme.