opentelemetry-php icon indicating copy to clipboard operation
opentelemetry-php copied to clipboard

[PHP] Add Project Status table for each Signal in README top section

Open trivikr opened this issue 1 year ago • 6 comments

Is your feature request related to a problem? Please describe.

The Project Status of Traces/Metrics/Logs Signals in OpenTelemetry is difficult to find in OpenTelemetry for ~~Java~~ PHP.

Describe the solution you'd like Add Project Status Table at the top of README, similar to how it's done in other implementations:

  • .NET https://github.com/open-telemetry/opentelemetry-dotnet
  • Go https://github.com/open-telemetry/opentelemetry-go
  • CPP https://github.com/open-telemetry/opentelemetry-cpp

The Status Table would list Signal and the current status

| Signal  | Status                            | Project                           |
| ------- | --------------------------------- | --------------------------------- |
| Traces  | Experimental/Alpha/Beta/RC/Stable | [version](link-to-github-project) |
| Metrics | Experimental/Alpha/Beta/RC/Stable | [version](link-to-github-project) |
| Logs    | Experimental/Alpha/Beta/RC/Stable | [version](link-to-github-project) |

Describe alternatives you've considered Going through repo contents to find the status of each Signal.

Additional context Summary table for OpenTelemetry Status https://github.com/open-telemetry/opentelemetry.io/issues/1548

trivikr avatar Jul 14 '22 14:07 trivikr

On a quick look at version numbers and GitHub projects, this is what I think the table is:

Signal Status Project
Traces Experimental Tracing
Metrics Experimental Metrics
Logs N/A Logging

If it's incorrect, please provide the correct table in this GitHub issue, so that it can be updated on README.

trivikr avatar Jul 14 '22 15:07 trivikr

@trivikr - the table looks pretty close to me I think we can call traces status "alpha" now). Did you want this assigned to you?

brettmc avatar Jul 14 '22 22:07 brettmc

The Project Status of Traces/Metrics/Logs Signals in OpenTelemetry is difficult to find in OpenTelemetry for Java.

-> https://github.com/open-telemetry/opentelemetry-java

tidal avatar Jul 15 '22 06:07 tidal

I'd use issue with OpenTelemetry Java as a reference while copying requests. Updated it to use PHP.

trivikr avatar Jul 15 '22 13:07 trivikr

The consensus is being achieved towards treating website as authoritative, and provide a link to website instead.

https://github.com/open-telemetry/opentelemetry-java/pull/4612#issuecomment-1185118267

We'll request the status page to link to language instrumentation links instead of GitHub READMEs in https://github.com/open-telemetry/opentelemetry.io/issues/1548

trivikr avatar Jul 15 '22 13:07 trivikr

The consensus is being achieved towards treating website as authoritative, and provide a link to website instead.

That's certainly not a consensus otherwise this sentence would be obsolete. If you are talking about the website repo, it's not authoritative in our case, as the truth about this libarary and its content is this repository which will not simply change because of any content on the website.

tidal avatar Jul 21 '22 20:07 tidal

Implemented in #816

brettmc avatar Sep 07 '22 13:09 brettmc