Skip to content

Conversation

@austinlparker
Copy link
Member

Adds a blog from the GC discussing proposed changes to stability and future project work/direction. cc @open-telemetry/governance-committee

@austinlparker austinlparker requested a review from a team as a code owner October 23, 2025 16:45
@otelbot-docs otelbot-docs bot requested a review from a team October 23, 2025 16:45
@github-actions github-actions bot added the blog label Oct 23, 2025
@julianocosta89
Copy link
Member

One point that is not mentioned on the blog, but it is important to help users navigate the project is repositories structure.
I was discussing SemConv with a colleague and I've noticed that each programming language has a different way of organizing them:

It would be great if we could follow the same pattern across all languages.

@dmathieu
Copy link
Member

I wonder if this post should emphasize more that all these are proposals that (I think and hope) need to be properly discussed with maintainers and contributors before they are finalized, and that the way they end up being implemented may change based on discussions with all the stakeholders of the project.

Copy link
Member

@pichlermarc pichlermarc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Big change. Personally, I love this idea. 🙌

I think this aligns very well with the the idea behind the JS SIG's focus-topic selection criteria - having backing for something like this on a project-wide level AND having this communicated so publicly sounds like it has the potential to be a huge boost to stabilization efforts.

austinlparker and others added 3 commits October 24, 2025 09:48
Co-authored-by: Juliano Costa <julianocosta89@outlook.com>
Co-authored-by: Damien Mathieu <42@dmathieu.com>
Co-authored-by: Pablo Baeyens <pbaeyens31+github@gmail.com>
Copy link
Contributor

@evan-bradley evan-bradley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mostly just wordsmithing suggestions right now, thanks for putting this together!

austinlparker and others added 2 commits October 27, 2025 11:49
Co-authored-by: Evan Bradley <11745660+evan-bradley@users.noreply.github.com>
Co-authored-by: Evan Bradley <11745660+evan-bradley@users.noreply.github.com>
austinlparker and others added 2 commits November 3, 2025 11:03
Co-authored-by: Severin Neumann <severin.neumann@altmuehlnet.de>
Copy link
Member

@alolita alolita left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added comments inline.

austinlparker and others added 3 commits November 3, 2025 13:53
Co-authored-by: Pablo Baeyens <pbaeyens31+github@gmail.com>
Co-authored-by: Pablo Baeyens <pbaeyens31+github@gmail.com>
Copy link
Member

@mx-psi mx-psi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Content LGTM, this would probably be more forceful if it's coming from the whole GC than from a single person individually but I am fine with either

parsed in a programmatic way. The exact format will be defined through an
OTEP and incorporated into the specification. As part of this, we'll be
normalizing stability levels across components, including semantic
conventions by introducing alpha/beta stability to that effort.
Copy link
Member

@trask trask Nov 4, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure that the Semconv SIG is in agreement with this statement yet:

introducing alpha/beta stability

I believe the Semconv SIG preference is to decouple telemetry stability from semconv stability

meaning that instrumentation libraries can produce "stable telemetry" which doesn't break dashboards or alerts without a major version bump in the instrumentation library

but that is independent to whether or not it follows any stable semantic conventions

@austinlparker
Copy link
Member Author

austinlparker commented Nov 4, 2025

note to self: in tldr characterize this as changing of the 'audience' for otel publicly to be more of a product/end user focus rather than spec artifacts -- our external stability should be more about artifact stability/usability rather than the internal spec stability markers that we need for uncoordinated improvement of sdks/apis/etc


This is a big change for maintainers, especially those who have shipped v1+ of
their libraries. We would deeply appreciate your feedback on this proposal in
the [discussion](https://github.com/open-telemetry/community/discussions/3098).
Copy link
Contributor

@tedsuo tedsuo Nov 4, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we need to turn discussions on for this? Could we stick to issues?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

given that this is probably a multi-threaded topic and issues don't work great for that, I think a discussion is a good venue for the overall conversation, especially since the individual OTEPs will be better at hashing out single-threaded details?

austinlparker and others added 5 commits November 4, 2025 17:32
Co-authored-by: Trask Stalnaker <trask.stalnaker@gmail.com>
Co-authored-by: Trask Stalnaker <trask.stalnaker@gmail.com>
Co-authored-by: Trask Stalnaker <trask.stalnaker@gmail.com>
Co-authored-by: Trask Stalnaker <trask.stalnaker@gmail.com>
Co-authored-by: Trask Stalnaker <trask.stalnaker@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.