-
Notifications
You must be signed in to change notification settings - Fork 1.6k
add blog post announcing proposed changes/oteps for stability work #8208
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
add blog post announcing proposed changes/oteps for stability work #8208
Conversation
|
One point that is not mentioned on the blog, but it is important to help users navigate the project is repositories structure.
It would be great if we could follow the same pattern across all languages. |
|
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. |
There was a problem hiding this 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.
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>
There was a problem hiding this 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!
Co-authored-by: Evan Bradley <11745660+evan-bradley@users.noreply.github.com>
Co-authored-by: Evan Bradley <11745660+evan-bradley@users.noreply.github.com>
Co-authored-by: Severin Neumann <severin.neumann@altmuehlnet.de>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Added comments inline.
Co-authored-by: Pablo Baeyens <pbaeyens31+github@gmail.com>
Co-authored-by: Pablo Baeyens <pbaeyens31+github@gmail.com>
There was a problem hiding this 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. |
There was a problem hiding this comment.
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
|
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). |
There was a problem hiding this comment.
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?
There was a problem hiding this comment.
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?
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>
Adds a blog from the GC discussing proposed changes to stability and future project work/direction. cc @open-telemetry/governance-committee