terminology.md provides a glossary for languages commonly used throughout the OpenTelemetry project.
The specification directory is the versioned OpenTelemetry standard, explaining the cross-language requirements and expectations for implementations.
semantic-conventions.md describes conventional tags, log keys, etc. that should be used for common scenarios to ensure a consistent usage experience.
Changes to the content of the specification itself, including changes to terminology and semantic conventions, are versioned according to Semantic Versioning and described in CHANGELOG.md. Layout changes are not versioned. Specific implementations of the specification should specify which version they implement.
Changes to the change process itself are not currently versioned but may be independently versioned in the future.
The change process is still evolving. For the short term, please use issues to suggest changes and pull requests to suggest implementations of changes that have been discussed in a relevant issue.
We will be setting up a more complete RFC process to streamline the discussion of changes.
By contributing to OpenTelemetry Specification repository, you agree that your contributions will be licensed under its Apache 2.0 License.