update file doc strings

Author: keith-decker

util/opentelemetry-util-genai/src/opentelemetry/util/genai/generators.py

@@ -13,23 +13,22 @@
 # limitations under the License.
 
 """
-Emitters for GenAI telemetry instrumentation.
+Span generation utilities for GenAI telemetry.
 
-This module defines classes and utilities for mapping GenAI (Generative AI) invocations
-to OpenTelemetry spans, metrics, and events. Emitters manage the lifecycle of telemetry
-data for LLM (Large Language Model) operations, including success and error reporting.
+This module maps GenAI (Generative AI) invocations to OpenTelemetry spans and
+applies GenAI semantic convention attributes.
 
 Classes:
-    BaseEmitter: Abstract base class for GenAI telemetry emitters.
-    SpanMetricEventEmitter: Emits spans, metrics, and events for full telemetry.
-    SpanMetricEmitter: Emits only spans and metrics (no events).
-
-Functions:
-    _get_property_value: Utility to extract property values from objects or dicts.
-    _message_to_log_record: Converts a GenAI message to an OpenTelemetry LogRecord.
-    _chat_generation_to_log_record: Converts a chat generation to a LogRecord.
-    _get_metric_attributes: Builds metric attributes for telemetry reporting.
-
+    - BaseTelemetryGenerator: Abstract base for GenAI telemetry emitters.
+    - SpanGenerator: Concrete implementation that creates and finalizes spans
+      for LLM operations (e.g., chat) and records input/output messages when
+      experimental mode and content capture settings allow.
+
+Usage:
+    See `opentelemetry/util/genai/handler.py` for `TelemetryHandler`, which
+    constructs `LLMInvocation` objects and delegates to `SpanGenerator.start`,
+    `SpanGenerator.finish`, and `SpanGenerator.error` to produce spans that
+    follow the GenAI semantic conventions.
 """
 
 import json

util/opentelemetry-util-genai/src/opentelemetry/util/genai/handler.py

@@ -15,23 +15,21 @@
 """
 Telemetry handler for GenAI invocations.
 
-This module provides the `TelemetryHandler` class, which manages the lifecycle of
-GenAI (Generative AI) invocations and emits telemetry data as spans, metrics, and events.
-It supports starting, stopping, and failing LLM invocations,
-and provides module-level convenience functions for these operations.
+This module exposes the `TelemetryHandler` class, which manages the lifecycle of
+GenAI (Generative AI) invocations and emits telemetry data (spans and related attributes).
+It supports starting, stopping, and failing LLM invocations.
 
 Classes:
-    TelemetryHandler: Manages GenAI invocation lifecycles and emits telemetry.
+    - TelemetryHandler: Manages GenAI invocation lifecycles and emits telemetry.
 
 Functions:
-    get_telemetry_handler: Returns a singleton TelemetryHandler instance.
-    llm_start: Starts a new LLM invocation.
-    llm_stop: Stops an LLM invocation and emits telemetry.
-    llm_fail: Marks an LLM invocation as failed and emits error telemetry.
+    - get_telemetry_handler: Returns a singleton `TelemetryHandler` instance.
 
 Usage:
-    Use the module-level functions (`llm_start`, `llm_stop`, `llm_fail`) to
-    instrument GenAI invocations for telemetry collection.
+    handler = get_telemetry_handler()
+    handler.start_llm(prompts, run_id, system="provider-name", **attrs)
+    handler.stop_llm(run_id, chat_generations, **attrs)
+    handler.fail_llm(run_id, error, **attrs)
 """
 
 import time