diff --git a/content/en/docs/languages/java/instrumentation.md b/content/en/docs/languages/java/instrumentation.md index 7585fd532508..85a266311493 100644 --- a/content/en/docs/languages/java/instrumentation.md +++ b/content/en/docs/languages/java/instrumentation.md @@ -1190,9 +1190,11 @@ meter ## Logs -Logs are distinct from Metrics and Tracing in that there is no user-facing logs -API. Instead, there is tooling to bridge logs from existing popular log -frameworks (e.g. SLF4j, JUL, Logback, Log4j) into the OpenTelemetry ecosystem. +Logs are distinct from metrics and traces in that **there is no user-facing +OpenTelemetry logs API**. Instead, there is tooling to bridge logs from existing +popular log frameworks (e.g. SLF4j, JUL, Logback, Log4j) into the OpenTelemetry +ecosystem. For rationale behind this design decision, see +[Logging specification](/docs/specs/otel/logs/). The two typical workflows discussed below each cater to different application requirements.