Skip to content

Commit

Permalink
[chore] [docs/component-stability.md] Document relationship between v…
Browse files Browse the repository at this point in the history
…ersioning and stability (open-telemetry#11863)

<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

Documents relationship between component stability and versioning.

<!-- Issue number if applicable -->
#### Link to tracking issue
Fixes open-telemetry#11851
  • Loading branch information
mx-psi authored and HongChenTW committed Dec 19, 2024
1 parent 284dd4f commit 1b2d59e
Showing 1 changed file with 9 additions and 0 deletions.
9 changes: 9 additions & 0 deletions docs/component-stability.md
Original file line number Diff line number Diff line change
Expand Up @@ -187,3 +187,12 @@ Components that were accepted based on being vendor-specific components will be
they have no active code owners from the vendor even if there are other code owners listed. As part of being marked unmaintained, we'll attempt to contact the vendor to notify them of the change. Other active code
owners may petition for its continued maintenance if they want, at which point the component will no
longer be considered vendor-specific.

## Versioning

Components are Go modules and as such follow [semantic versioning](https://semver.org/). Go API stability guarantees are covered in the [VERSIONING.md](../VERSIONING.md) document.
The versioning of the components applies to all signals simultaneously. For a component to be marked as 1.x it MUST be stable for at least one signal.

Even if a component has a 1.x or greater version, its behavior for specific signals might change in ways that break end users if the component is not stable for a particular signal.
Go API stability guarantees apply to ALL signals, regardless of their stability level.
This means that signal-specific configuration options MUST NOT be removed or changed in a way that breaks our Go API compatibility promise, even if the signal is not stable.

0 comments on commit 1b2d59e

Please sign in to comment.