Logs specification seems inconsistent

[Yas-Franco]

There are contradictory statements in the Logs specification.

As of #4352, the logs API has been made user-facing. The specification states that the API can be called by applications:

The Logs API can also be directly called by instrumentation libraries as well as instrumented libraries or applications.

https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/logs/api.md?plain=1#L37

The specification still states that developers are not encouraged to call the API directly:

Application developers are NOT encouraged to call this API directly. It is provided for library authors to build

https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/logs/README.md?plain=1#L148

Is it true that the Logs API can be directly called but it is still not encouraged? I think this needs specifying in the documenation

[pellared]

Thank your for submitting the issue.

It does not need to be discouraged anymore. This is a leftover. I will try to address it.

The same question was asked recently on Slack: https://cloud-native.slack.com/archives/C062HUREGUV/p1740408386699089

Still it is worth to call out that it is just a Specification and languages need time to adapt. Some languages may still prefer users to not use Logs (Bridge) API directly.