open-telemetry / opentelemetry.io

The OpenTelemetry website and documentation
https://opentelemetry.io
Creative Commons Attribution 4.0 International
565 stars 1.23k forks source link

Proposal: Regarding adding the display of the old version of `OpenTelemetry Semantic Conventions` on the official website #5417

Open flc1125 opened 1 month ago

flc1125 commented 1 month ago

OpenTelemetry Semantic Conventions 1.28.0

I found that the surrounding ecosystems based on this specification (including, for example: languages, vendors) are relatively lagging behind. They may still need time to adapt to the new specification.

I can understand that this is a relatively long process. Just in daily use, I need to combine the language and the vendor used to select the current latest version. And this latest version should be the latest version supported by both the language and the vendor.

So, a situation that I often encounter is that I need to check the documents of the previous old versions to adjust my code.

For this reason, I think many people should have this situation. So, I urgently hope that the official can support the viewing of the online documents of the old versions.


Some materials:

[!NOTE] If you agree or disagree, you can vote by clicking the emoticons below.

flc1125 commented 1 month ago

Temporary solution:

I currently select the corresponding version through the Github repository to view the relevant information, but this is obviously not as convenient as the official website.

ex: https://github.com/open-telemetry/semantic-conventions/tree/v1.26.0/docs

svrnm commented 1 month ago

Thank you for raising this @flc1125!

@open-telemetry/docs-approvers @open-telemetry/spec-sponsors @open-telemetry/technical-committee please take a look