docs(specs): Publish spec compliance matrix#9358
docs(specs): Publish spec compliance matrix#9358lehmannro wants to merge 4 commits intoopen-telemetry:mainfrom
Conversation
The table, which the `opentelemetry-specification` goes to great lengths of creating and maintaining, is otherwise unused. This leads to e.g. [blog posts having to link to](https://opentelemetry.io/blog/2026/stable-declarative-config/) Github directly through: * https://github.com/open-telemetry/opentelemetry-specification/blob/main/spec-compliance-matrix.md
Some links in that table are written relative to the `opentelemetry-specification` repository, which is copied into `./docs/specs/otel/`.
|
I realize some of the links are still broken; could I get some indication if the approach is sane in general, then I'll happily tweak |
|
Preview: https://deploy-preview-9358--opentelemetry.netlify.app/docs/languages/spec-compliance-matrix/ Interesting idea & solution, @lehmannro , we need to check a few things here, if this is maintanable long term. @open-telemetry/spec-sponsors PTAL! |
|
Would it make more sense for this to reside alongside the spec within the spec branch of the navigation. It might be useful to see if we could also generate 1 page per language and have that mounted under the appropriate language. That way if someone is looking at the .net docs they can easily see what features have been implemented. |
Some links point to `README.md` files which get rendered to `index.html` (or, the `/` redirect). This is true for both, links inside the already adjusted `/docs/specs/otel` tree and outside (`.../semconv`) so we cannot just tweak the first regexp a little.
|
I went and fixed up all links through As for where in the navigation this lives, I don't feel strongly. To me, Languages makes most sense because I'd probably use this page when I'm looking at a particular language / across languages, rather than into the specification only. YMMV. Splitting up sounds like a more involved project because we'd need to fetch the individual YAML files and generate our own tables, much like the current |
This will publish the
Compliance of Implementations with Specificationmatrix, currently only on Github, underhttps://opentelemetry.io/docs/languages/spec-compliance-matrix(titled Spec compliance.)Footnotes
Yes, I can answer maintainer questions about the content of this PR, without using AI. ↩