diff --git a/CHANGELOG.md b/CHANGELOG.md index 35f25da3164..8fb0f4994c9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -37,6 +37,7 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm - Fix `Code.UnmarshalJSON` to work with valid json only. (#1276) - The `resource.New()` method changes signature to support builtin attributes and functional options, including `telemetry.sdk.*` and `host.name` semantic conventions; the former method is renamed `resource.NewWithAttributes`. (#1235) +- Correct the `Span.End` method documentation in the `otel` API to state updates are not allowed on a span after it has ended. (#1310) ### Removed diff --git a/trace/trace.go b/trace/trace.go index a5fe7066ac9..76016e5bb6e 100644 --- a/trace/trace.go +++ b/trace/trace.go @@ -246,8 +246,10 @@ type Span interface { // nil. Tracer() Tracer - // End completes the Span. Updates are not allowed the Span after End is - // called other than setting the status. + // End completes the Span. The Span is considered complete and ready to be + // delivered through the rest of the telemetry pipeline after this method + // is called. Therefore, updates to the Span are not allowed after this + // method has been called. End(options ...SpanOption) // AddEvent adds an event with the provided name and options.