opentracing / opentracing-java

OpenTracing API for Java. 🛑 This library is DEPRECATED! https://github.com/opentracing/specification/issues/163
http://opentracing.io
Apache License 2.0
1.68k stars 344 forks source link

When are the wild api changes expected to settle down? #349

Closed rvowles closed 5 years ago

rvowles commented 5 years ago

Because we depend on other libraries as well as our own wrapped around open tracing, wild API changes such as have happened from 0.31 -> 0.33 are undesirable. Before making any attempt to upgrade, it would be useful to know when these backwards incompatible API changes will settle down. As such we will stick with 0.31 before investing more time.

whiskeysierra commented 5 years ago

Starting with 1.0, I guess.

austinlparker commented 5 years ago

More seriously, I believe that we expect 0.33 to be somewhat stable as we're building the OpenTracing -> OpenTelemetry adapter against it (see https://medium.com/opentracing/a-roadmap-to-convergence-b074e5815289 for more).

rvowles commented 5 years ago

Thanks Austin - that was really helpful. Willi not so much.

On Thu, May 9, 2019 at 3:12 PM Austin Parker notifications@github.com wrote:

More seriously, I believe that we expect 0.33 to be somewhat stable as we're building the OpenTracing -> OpenTelemetry adapter against it (see https://medium.com/opentracing/a-roadmap-to-convergence-b074e5815289 for more).

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/opentracing/opentracing-java/issues/349#issuecomment-490726652, or mute the thread https://github.com/notifications/unsubscribe-auth/AAANTWE5MEMT2YK64QL2VOTPUOJAZANCNFSM4HLVVZAQ .

--

Richard Vowles, Full stack - from Kubernetes, through Node & Java, Web and Mobile development in Flutter - software developer for hire!

ph: +64275467747, web: www.google.com/+RichardVowles

whiskeysierra commented 5 years ago

Willi not so much.

My statement was a snotty response to the provoking title.

In all seriousness though:

Major version zero (0.y.z) is for initial development. Anything may change at any time. The public API should not be considered stable.

https://semver.org/#spec-item-4

I'm assuming semantic versioning is used based on https://github.com/opentracing/opentracing-java/pull/114#issuecomment-290450288. A one liner in the readme regarding versioning would be nice.

austinlparker commented 5 years ago

Thanks for the suggestion about making the semver expectations more clear in the readme, @whiskeysierra.

Closing this issue.