community icon indicating copy to clipboard operation
community copied to clipboard

[toc] central jump off point for release process / documentation

Open dims opened this issue 6 months ago • 4 comments

For the CNCF Graduation issue, we are looking into release process for various repositories: https://github.com/cncf/toc/issues/1739

It looks like there isn't a central place where we can find information as it is spread across all the repos: https://github.com/search?q=org%3Aopen-telemetry+path%3Areleas*.md&type=code&p=1

Is there some common things across these? Like who makes the release? when do you make the release? how do you figure out who will handle the next release?

May be a table with links to individual processes for each repo will be a good start? and document some of the common things / themes that cut across these repos would be good information to have?

thanks, Dims

dims avatar Jun 13 '25 17:06 dims

cc @austinlparker @thefoxatwork

dims avatar Jun 13 '25 17:06 dims

We can certainly look into providing this!

austinlparker avatar Jun 13 '25 17:06 austinlparker

@austinlparker first step is to reflect current state of affairs. then it would be figuring out how to ensure there are some common patterns / procedures so folks can hop from one to another (and for those looking in to understand what to expect etc)

dims avatar Jun 13 '25 17:06 dims

examples

  • https://containerd.io/releases/
  • https://kubernetes.io/releases/release/
  • https://github.com/dapr/community/blob/master/release-process.md

I do understand that otel has a LOT more individual pieces compared to other projects for sure, which makes it all the more desirable to have some common elements.

dims avatar Jun 13 '25 17:06 dims

@dims please take a look at https://github.com/open-telemetry/community/blob/main/RELEASE.md and let me know if there's anything else you'd want to see there.

austinlparker avatar Jun 23 '25 17:06 austinlparker

Austin, can you please check on the links to the teams links? "Release Maintainers"

is there a link to criteria for folks aspiring to becoming one of these maintainers?

dims avatar Jun 23 '25 18:06 dims

Austin, can you please check on the links to the teams links? "Release Maintainers"

is there a link to criteria for folks aspiring to becoming one of these maintainers?

The links point to the maintainers team for each repository. Are you not able to access it? Our general guidance on becoming a maintainer is defined in the membership guide at https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#maintainer.

ed: For clarity's sake, no SIG currently has different maintainers and release maintainers (there is no separate 'release team'). This is because all of our SIGs/subprojects release more or less independently in response to several events which are laid out in the table in that release file. In the future, we'll evaluate the possibility of moving to a 'wave' release that normalizes this across all repositories/artifacts.

austinlparker avatar Jun 23 '25 18:06 austinlparker

first 3 links for example are 404-ing for me

Image

Image

dims avatar Jun 23 '25 18:06 dims

first 3 links for example are 404-ing for me

Image

Image

Hm, ok, weird. I would have thought someone in the CNCF org would be able to access those. Let me see what we can do.

austinlparker avatar Jun 23 '25 18:06 austinlparker

What if we added a link to https://opentelemetry.io/community/members/#maintainers and told people to cross-reference that against the repo/sig...? It's not the only place to find it (conventionally, all repos should have this info in their README.md as well) but would that work for now?

austinlparker avatar Jun 23 '25 18:06 austinlparker

@austinlparker sure, let's do what we can to make it easier to find people

dims avatar Jun 27 '25 12:06 dims

oops didn't mean to close this from that PR

trask avatar Jul 01 '25 14:07 trask

hi @dims! the release maintainer links should work for external folks now

trask avatar Jul 01 '25 14:07 trask

thanks @trask

dims avatar Jul 27 '25 02:07 dims