Do not discourage direct usage of Logs API

CHANGELOG.md

@@ -33,6 +33,8 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - `go.opentelemetry.io/otel/sdk/log/logtest` is now a separate Go module. (#6466)
 - `Recorder` in `go.opentelemetry.io/otel/log/logtest` no longer separately stores records emitted by loggers with the same instrumentation scope. (#6507)
 - Improve performance of `BatchProcessor` in `go.opentelemetry.io/otel/sdk/log` by not exporting when exporter cannot accept more. (#6569, #6641)
+- Updated documentation in `go.opentelemetry.io/otel/log`; no longer discourages direct usage of the Logs API. (#6675)
+- Renamed `Logs Bridge API` to `Logs API` across several documentation files for consistency. (#6675)
 
 ### Deprecated
 

log/doc.go

@@ -4,10 +4,11 @@
 /*
 Package log provides the OpenTelemetry Logs API.
 
-This package is intended to be used by bridges between existing logging
-libraries and OpenTelemetry. Users should not directly use this package as a
-logging library. Instead, install one of the bridges listed in the
-[registry], and use the associated logging library.
+This package defines the API for emitting LogRecords and provides a standard
+interface for integration with the OpenTelemetry ecosystem. It enables the
+use of log appenders (bridges) to connect existing logging libraries with the
+OpenTelemetry log data model. A variety of bridges for popular logging
+libraries are available in the [registry].
 
 # API Implementations
 

log/embedded/embedded.go

@@ -4,33 +4,33 @@
 // Package embedded provides interfaces embedded within the [OpenTelemetry Logs
 // Bridge API].
 //
-// Implementers of the [OpenTelemetry Logs Bridge API] can embed the relevant
+// Implementers of the [OpenTelemetry Logs API] can embed the relevant
 // type from this package into their implementation directly. Doing so will
 // result in a compilation error for users when the [OpenTelemetry Logs Bridge
 // API] is extended (which is something that can happen without a major version
 // bump of the API package).
 //
-// [OpenTelemetry Logs Bridge API]: https://pkg.go.dev/go.opentelemetry.io/otel/log
+// [OpenTelemetry Logs API]: https://pkg.go.dev/go.opentelemetry.io/otel/log
 package embedded // import "go.opentelemetry.io/otel/log/embedded"
 
-// LoggerProvider is embedded in the [Logs Bridge API LoggerProvider].
+// LoggerProvider is embedded in the [Logs API LoggerProvider].
 //
-// Embed this interface in your implementation of the [Logs Bridge API
+// Embed this interface in your implementation of the [Logs API
 // LoggerProvider] if you want users to experience a compilation error,
 // signaling they need to update to your latest implementation, when the [Logs
 // Bridge API LoggerProvider] interface is extended (which is something that
 // can happen without a major version bump of the API package).
 //
-// [Logs Bridge API LoggerProvider]: https://pkg.go.dev/go.opentelemetry.io/otel/log#LoggerProvider
+// [Logs API LoggerProvider]: https://pkg.go.dev/go.opentelemetry.io/otel/log#LoggerProvider
 type LoggerProvider interface{ loggerProvider() }
 
-// Logger is embedded in [Logs Bridge API Logger].
+// Logger is embedded in [Logs API Logger].
 //
-// Embed this interface in your implementation of the [Logs Bridge API Logger]
+// Embed this interface in your implementation of the [Logs API Logger]
 // if you want users to experience a compilation error, signaling they need to
-// update to your latest implementation, when the [Logs Bridge API Logger]
+// update to your latest implementation, when the [Logs API Logger]
 // interface is extended (which is something that can happen without a major
 // version bump of the API package).
 //
-// [Logs Bridge API Logger]: https://pkg.go.dev/go.opentelemetry.io/otel/log#Logger
+// [Logs API Logger]: https://pkg.go.dev/go.opentelemetry.io/otel/log#Logger
 type Logger interface{ logger() }

log/global/log.go

@@ -3,7 +3,7 @@
 
 /*
 Package global provides access to a global implementation of the OpenTelemetry
-Logs Bridge API.
+Logs API.
 
 This package is experimental. It will be deprecated and removed when the [log]
 package becomes stable. Its functionality will be migrated to

log/noop/noop.go

@@ -4,14 +4,14 @@
 // Package noop provides an implementation of the [OpenTelemetry Logs Bridge
 // API] that produces no telemetry and minimizes used computation resources.
 //
-// Using this package to implement the [OpenTelemetry Logs Bridge API] will
+// Using this package to implement the [OpenTelemetry Logs API] will
 // effectively disable OpenTelemetry.
 //
 // This implementation can be embedded in other implementations of the
-// [OpenTelemetry Logs Bridge API]. Doing so will mean the implementation
+// [OpenTelemetry Logs API]. Doing so will mean the implementation
 // defaults to no operation for methods it does not implement.
 //
-// [OpenTelemetry Logs Bridge API]: https://pkg.go.dev/go.opentelemetry.io/otel/log
+// [OpenTelemetry Logs API]: https://pkg.go.dev/go.opentelemetry.io/otel/log
 package noop // import "go.opentelemetry.io/otel/log/noop"
 
 import (

sdk/log/doc.go

@@ -31,6 +31,6 @@ is being run on. That way when multiple instances of the code are collected
 at a single endpoint their origin is decipherable.
 
 See [go.opentelemetry.io/otel/log] for more information about
-the OpenTelemetry Logs Bridge API.
+the OpenTelemetry Logs API.
 */
 package log // import "go.opentelemetry.io/otel/sdk/log"