semantic-conventions icon indicating copy to clipboard operation
semantic-conventions copied to clipboard

Document rationale when conventions do not follow existing guidance

Open trask opened this issue 6 months ago • 0 comments

Sometimes there's a good reason not to follow existing guidance, but it can be hard to review semantic conventions without knowing this reasoning, or understanding the scope that the reasoning applies to, e.g. https://github.com/open-telemetry/semantic-conventions/pull/2180#discussion_r2060698638.

It would be great if these rationales were documented somewhere under docs/non-normative.

We could even have one doc for the rationale "stabilized already 🤷".

trask avatar May 08 '25 20:05 trask