Skip to content

Commit

Permalink
Explain stability guarantees for experimental pkgs
Browse files Browse the repository at this point in the history
  • Loading branch information
MrAlias committed Jun 6, 2024
1 parent 4ef95d5 commit 7af8156
Showing 1 changed file with 14 additions and 2 deletions.
16 changes: 14 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,22 @@ Generated Go code for the OpenTelemetry protobuf data model.

## Versioning Policy

The autogenerated Go code follows the stability guarantees as defined in
The auto-generated Go code follows the stability guarantees as defined in
[maturity
level](https://github.com/open-telemetry/opentelemetry-proto?tab=readme-ov-file#maturity-level).
Packages suffixed as `experimental` might not be kept indefinitely.

Versioning of modules in this project will be idiomatic of a Go project using [Go modules](https://github.com/golang/go/wiki/Modules).
They will use [semantic import versioning](https://github.com/golang/go/wiki/Modules#semantic-import-versioning).
Meaning modules will comply with [semver 2.0](https://semver.org/spec/v2.0.0.html) with the following exception:

- Packages with an `experimental` suffix do not comply with [semver 2.0](https://semver.org/spec/v2.0.0.html).
- Backwards incompatible changes may be introduced to these packages between minor versions.
- These packages are intended to be temporary.
They will be deprecated and removed when the protobuf definition stabilizes or is removed.
If the protobuf definition stabilizes, the package will be replaced with a stable "non-experimental" package.
If the protobuf definition is removed, the package will be removed without a replacement.

might not be kept indefinitely.

## Getting Started

Expand Down

0 comments on commit 7af8156

Please sign in to comment.