[Page feedback]: No actual explanation of what Context objects are intended for

[craigsoules]

URL

https://opentelemetry.io/docs/specs/otel/context/

Description

It looks like, from the code, that Context objects are intended to be function scoped, since when the returned Token is destroyed it pop()'s it's context off the stack. But there's no explanation of what the use cases for Context is anywhere, so it's very confusing to people who aren't familiar with OTel. Please provide some example use cases, best practices, etc.

[svrnm]

hey @craigsoules,

the page you are looking at is from the opentelemetry specification, which is a technical document, that requires having some understanding already. The page you might be looking for is here:

https://opentelemetry.io/docs/concepts/context-propagation/

Additionally there are some language specific pages on context & context propagation.

@open-telemetry/spec-sponsors PTAL, if this is something that can be changed in the spec, so I would move the issue to the spec repo