Clarify experimental additions to Stable components #597
Conversation
The Entities SIG is planning a backward-compatible addition to the Resource, see the prototype here: #2 The change is compliant with existing stability requirements in this repository. However, our stability definition does not specify how such experimental additions to stable signals are expected to be done and what happens during and after the experiment. This PR adds more clarity in the process and further refines the stability definition to reinforce our strong commitment ot OTLP's stability.
- Match the requirements defined in open-telemetry#597 - Use v1development instead of v1 to match what we do for profiles: https://github.com/open-telemetry/opentelemetry-proto/tree/main/opentelemetry/proto/profiles/v1development
|
As an example, here is the application of these rules to the Entities experimental signal: tigrannajaryan#2 |
|
@open-telemetry/spec-sponsors when you all get tired from walking the Kubecon floor please take a look at this PR :-) |
|
@open-telemetry/technical-committee @open-telemetry/spec-sponsors please take a look. |
Yes, that's implied. We will not be accepting experimental fields unless there is significant upfront work done that demonstrates how the field is supposed to work. An example of that is entities SIG's upcoming changes to the Resource. We have multiple prototypes in different languages and in the Collector already, but we were very careful and haven't made the proto field proposal yet. We want to have a high confidence level before the field is added. |
The Entities SIG is planning a backward-compatible addition to the Resource, see the prototype here: tigrannajaryan#2
The change is compliant with existing stability requirements in this repository.
However, our stability definition does not specify how such experimental additions to stable signals are expected to be done and what happens during and after the experiment.
This PR adds more clarity in the process and further refines the stability definition to reinforce our strong commitment ot OTLP's stability.