`:telemetry.span/3` documentation seems inconsistent about telemetry HOT 4 CLOSED

I'm not sure why that isn't the behavior.

from telemetry.

We don't perform any merging, so indeed the docs are inaccurate. PRs welcome!

from telemetry.

Hello! I'm still a tad confused about this, even after the linked PR got merged.

In the quoted documentation paragraph, the docs mention that a reporter should be able to rely entirely on the stop event. However, this doesn't seem possible if StartMetadata isn't merged (automatically) into StopMetadata, because there is possibly a large amount of metadata that is unavailable to the stop event by default, and must be manually merged into the stop metadata when a span wrapper is implemented.

This seems to me that it makes it very easy to implement telemetry in a way which makes reporters very arduous to write (with need for long-running state to track and match span-related events via their references). I'm unsure if this is the intent, or if the documentation is incorrect, or if I'm just misunderstanding things entirely.

from telemetry.

However, this doesn't seem possible if StartMetadata isn't merged (automatically) into StopMetadata,

we should document that it is extremely Recommended for callers to return the stop metadata as a superset of the start metadata.

from telemetry.