diff --git a/specification/compatibility/opentracing.md b/specification/compatibility/opentracing.md index 30f5af8c9e5..fc8a4c81cc9 100644 --- a/specification/compatibility/opentracing.md +++ b/specification/compatibility/opentracing.md @@ -130,7 +130,7 @@ MUST be done by the Shim layer in order to retain these invariants. Because of the previous requirement, a given OpenTelemetry `Span` MUST be associated with ONE AND ONLY ONE `SpanContext` Shim object at all times -for ALL execution units, in order to keep any linked `Baggage` consistent +for ALL [execution units](../glossary.md#execution-unit), in order to keep any linked `Baggage` consistent at all times. It MUST BE safe to get and set the associated `SpanContext` Shim object for a specified OpenTelemetry `Span` from different execution units. diff --git a/specification/context/context.md b/specification/context/context.md index 3a9c4c7e216..663bd5fdf9e 100644 --- a/specification/context/context.md +++ b/specification/context/context.md @@ -23,7 +23,7 @@ ## Overview A `Context` is a propagation mechanism which carries execution-scoped values -across API boundaries and between logically associated execution units. +across API boundaries and between logically associated [execution units](../glossary.md#execution-unit). Cross-cutting concerns access their data in-process using the same shared `Context` object. diff --git a/specification/glossary.md b/specification/glossary.md index 34df1ffe73d..6d66930add5 100644 --- a/specification/glossary.md +++ b/specification/glossary.md @@ -28,6 +28,7 @@ Some other fundamental terms are documented in the [overview document](overview. * [Instrumented Library](#instrumented-library) * [Instrumentation Library](#instrumentation-library) * [Tracer Name / Meter Name](#tracer-name--meter-name) + * [Execution Unit](#execution-unit) - [Logs](#logs) * [Log Record](#log-record) * [Log](#log) @@ -156,6 +157,10 @@ This refers to the `name` and (optional) `version` arguments specified when creating a new `Tracer` or `Meter` (see [Obtaining a Tracer](trace/api.md#tracerprovider)/[Obtaining a Meter](metrics/api.md#meterprovider)). The name/version pair identifies the [Instrumentation Library](#instrumentation-library). +### Execution Unit + +An umbrella term for the smallest unit of sequential code execution, used in different concepts of multitasking. Examples are threads, coroutines or fibers. + ## Logs ### Log Record