Skip to content

Commit

Permalink
Define OTLP 1.0 Stability guarantees
Browse files Browse the repository at this point in the history
  • Loading branch information
tigrannajaryan committed Apr 20, 2023
1 parent 395c842 commit 217a212
Showing 1 changed file with 11 additions and 19 deletions.
30 changes: 11 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,23 +48,18 @@ for definition of maturity levels).
Components marked `Stable` provide the following guarantees:

- Field types, numbers and names will not change.
- Numbers assigned to enum choices will not change.
- Service names and service package names will not change.
- Service operation names, parameter and return types will not change.

The following changes are allowed:

- Message names may change.
- Enum names may change.
- Enum choice names may change. This is allowed because enum choice names are not sent on
the wire.
- The location of messages and enums, i.e. whether they are declared at the top
lexical scope or nested inside another message may change.
- Package names may change.
- Directory structure, location and the name of the files may change.

Note that none of the above allowed changes affects the binary wire representation or the
JSON wire representation.
- Service method names will not change.
- Service method parameter names will not change.
- Service method parameter types and return types will not change.
- Service method kind (unary vs streaming) will not change.
- Names of messages and enums will not change.
- Names of enum choices and numbers assigned to enum choices will not change.
- The location of messages and enums, i.e. whether they are declared at the top lexical
scope or nested inside another message will not change.
- Package names and directory structure will not change.
- `optional` and `repeated` declarators of existing fields will not change.
- No existing symbol will be deleted.

The following additive changes are allowed:

Expand All @@ -79,9 +74,6 @@ All the additive changes above must be accompanied by an explanation about how
new and old senders and receivers that implement the version of the protocol
before and after the change interoperate.

No guarantees are provided whatsoever about the stability of the code that
is generated from the .proto files by any particular code generator.

## Experiments

In some cases we are trying to experiment with different features. In this case,
Expand Down

0 comments on commit 217a212

Please sign in to comment.