Page feedback - exporter (delimiters)

[sparecycles]

Suggested improvements for page: https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md

The "Specifying headers via environment variables" section mentions semi-colon delimited values:

The OTEL_EXPORTER_OTLP_HEADERS, OTEL_EXPORTER_OTLP_TRACES_HEADERS, OTEL_EXPORTER_OTLP_METRICS_HEADERS, OTEL_EXPORTER_OTLP_LOGS_HEADERS environment variables will contain a list of key value pairs, and these are expected to be represented in a format matching to the W3C Baggage, except that additional semi-colon delimited metadata is not supported, i.e.: key1=value1,key2=value2. All attribute values MUST be considered strings.

but the i.e., example is comma-delimited. So is that an example of what to do or what not to do? (that is the question).

Edited by @svrnm to change the URL from opentelemetry.io to the source file in the repo

[svrnm]

thanks for raising this issue @sparecycles! Since that file is sourced from the spec repository I will move your issue there

[pellared]

@sparecycles, please read it another time

these are expected to be represented in a format matching to the W3C Baggage, except that additional semi-colon delimited metadata is not supported

Therefore, it is an example of what to do.

[trask]

I agree it reads a bit confusing, I think a clarification PR would be welcome