open-feature / spec

OpenFeature specification
https://openfeature.dev
Apache License 2.0
597 stars 35 forks source link

chore: add additional document statuses #139

Closed toddbaert closed 1 year ago

toddbaert commented 1 year ago

Adds document statuses explaining stability of various spec documents and sub-sections.

This is important as we move toward's 1.0 SDK releases and a stable spec.

toddbaert commented 1 year ago

I'm not sure the benefit of Mixed, but it's not like it's a problem

Ya I was hesitant about Mixed. It's not really a meaningful status unto itself, but more of a meta-status. I feel confident about the rest.

TBH we can probably completely remove it. We can annotate sections with statuses, it just means you'll have navigate to them to see them.

InTheCloudDan commented 1 year ago

Is there going to be requirements or guidelines on how the promotion is determined? For example what is required to go from Experimental -> Hardening?

toddbaert commented 1 year ago

Is there going to be requirements or guidelines on how the promotion is determined? For example what is required to go from Experimental -> Hardening?

@InTheCloudDan that's a good question. I think some kind of formality could be good. I'm not sure what that could be. I'll think about it :thinking:

Anyone else have ideas for this?

toddbaert commented 1 year ago

It is the responsibility of the Technical Steering Committee to consider and approve the graduation of documents.

@InTheCloudDan @AloisReitbauer