open-telemetry / semantic-conventions

Defines standards for generating consistent, accessible telemetry across a variety of domains
Apache License 2.0
274 stars 175 forks source link

K8s: write migration guide for (to-be) stable semconv #1537

Open ChrsMark opened 2 weeks ago

ChrsMark commented 2 weeks ago

Similar to docs/non-normative/http-migration.md and docs/non-normative/db-migration.md, and also https://github.com/open-telemetry/semantic-conventions/pull/1198.

ChrsMark commented 2 weeks ago

@joaopgrassi @lmolkova would that make sense to create and merge a document already instead of keeping a long running draft PR like the https://github.com/open-telemetry/semantic-conventions/pull/1198.

We can mark the document as non-final somehow.

This will allow us to iterate on the document and allow multiple to contribute to it.

Also we could already start referencing to it by the Collector's components, even if it's state is not marked as finalized yet.