diff --git a/README.md b/README.md index ed815f9ad..a437f7aaf 100644 --- a/README.md +++ b/README.md @@ -1 +1,42 @@ -# opentelemetry-specification +# OpenTelemetry Specification + +![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/open-telemetry/specification.svg) ![GitHub tag (latest SemVer pre-release)](https://img.shields.io/github/tag-pre/opentelemetry/specification.svg) + +* [Layout](#layout) + * [Terminology](#terminology) + * [Specification](#specification) + * [Semantic Conventions](#semantic-conventions) + * [Wire Protocol](#wire-protocol) +* [Versioning](#versioning) +* [Change Process](#change-process) +* [License](#license) + +## Layout + +### [Terminology](./terminology.md) + +[terminology.md](./terminology.md) provides a glossary for languages commonly used throughout the OpenTelemetry project. + +### [Specification](./specification.md) + +[specification.md](./specification.md) is the versioned OpenTelemetry standard, explaining the cross-language requirements and expectations for implementations. + +### [Semantic Conventions](./semantic-conventions.md) + +[semantic-conventions.md](./semantic-conventions.md) describes conventional tags, log keys, etc. that should be used for common scenarios to ensure a consistent usage experience. + +## Versioning + +Changes to the content of the [specification](./specification.md) itself, including changes to [terminology](./terminology.md) and [semantic conventions](./semantic-conventions.md), are versioned according to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) and described in [CHANGELOG.md](./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. + +## Change Process + +The change process is still evolving. For the short term, please use [issues](https://github.com/open-telemetry/specification/issues) to suggest changes and [pull requests](https://github.com/open-telemetry/specification/pulls) 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. + +## License + +By contributing to OpenTelemetry Specification repository, you agree that your contributions will be licensed under its [Apache 2.0 License](https://github.com/open-telemetry/specification/blob/master/LICENSE). diff --git a/semantic-conventions.md b/semantic-conventions.md new file mode 100644 index 000000000..fa1459d8d --- /dev/null +++ b/semantic-conventions.md @@ -0,0 +1 @@ +# Semantic Conventions diff --git a/specification.md b/specification.md new file mode 100644 index 000000000..33e610415 --- /dev/null +++ b/specification.md @@ -0,0 +1 @@ +# Specification diff --git a/terminology.md b/terminology.md new file mode 100644 index 000000000..e2e2597f4 --- /dev/null +++ b/terminology.md @@ -0,0 +1 @@ +# Terminology