clean up

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/LibraryTelemetryOptions.java

@@ -11,8 +11,8 @@
  * Options for configuring library-specific telemetry settings.
  *
  * <p><strong>This class is intended to be used by the client libraries only. Library options must not be provided or modified
- * by application code</strong>
- * <p>
+ * by application code</strong></p>
+ *
  * Library options describe the client library - it's name, version, and schema URL.
  * Schema URL describes telemetry schema and version.
  * <p>

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/TelemetryProvider.java

@@ -11,7 +11,7 @@
 import static io.clientcore.core.telemetry.NoopTelemetryProvider.NOOP_PROVIDER;
 
 /**
- * Provides observability capabilities (distributed tracing, metrics, etc.) with OpenTelemetry to the client library.
+ * A container that can resolve observability provider and its components. Only OpenTelemetry is supported.
  *
  * <p><strong>This interface is intended to be used by client libraries. Application developers
  * should use OpenTelemetry API directly</strong></p>

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/tracing/Span.java

@@ -5,13 +5,7 @@
 
 /**
  * A {@code Span} represents a single operation within a trace. Spans can be nested to form a trace tree.
- * <p>
- *
- * This span is a wrapper over OpenTelemetry's span,
- * <p>
- *
- * <strong>Classes in this package are not intended to be used by client libraries. Application developers
- * should use OpenTelemetry API directly</strong>
+ * <p><strong>This interface is intended to be used by client libraries only. Application developers should use OpenTelemetry API directly</strong></p>
  */
 public interface Span {
     /**

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/tracing/SpanBuilder.java

@@ -5,10 +5,7 @@
 
 /**
  * Represents a span builder.
- * <p>
- *
- * <strong>Classes in this package are not intended to be used by client libraries. Application developers
- * should use OpenTelemetry API directly</strong>
+ * <p><strong>This interface is intended to be used by client libraries only. Application developers should use OpenTelemetry API directly</strong></p>
  */
 public interface SpanBuilder {
 

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/tracing/SpanContext.java

@@ -6,10 +6,8 @@
 /**
  * Uniquely identifies span in a trace. It is propagated over the wire and
  * is used to correlated spans across different services.
- * <p>
- *
- * <strong>Classes in this package are not intended to be used by client libraries. Application developers
- * should use OpenTelemetry API directly</strong>
+ * <p><strong>This interface is intended to be used by client libraries only. Application developers
+ * should use OpenTelemetry API directly</strong></p>
  */
 public interface SpanContext {
 

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/tracing/SpanKind.java

@@ -5,10 +5,8 @@
 
 /**
  * Represents the span kind.
- * <p>
- *
- * <strong>This enum is intended to be used by client libraries. Application developers
- * should use OpenTelemetry API directly</strong>
+ * <p><strong>This enum is intended to be used by client libraries only. Application developers
+ * should use OpenTelemetry API directly</strong></p>
  */
 public enum SpanKind {
     /**

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/tracing/TextMapGetter.java

@@ -5,6 +5,7 @@
 
 /**
  * A {@code TextMapGetter} retrieves context fields from a carrier, such as {@link io.clientcore.core.http.models.HttpRequest}.
+ * <p><strong>This interface is intended to be used by client libraries only. Application developers should use OpenTelemetry API directly</strong></p>
  *
  * @param <C> the type of the carrier.
  */

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/tracing/TextMapPropagator.java

@@ -8,6 +8,7 @@
 /**
  * A {@code TextMapPropagator} injects and extracts tracing context from a carrier,
  * such as {@link io.clientcore.core.http.models.HttpRequest}.
+ * <p><strong>This interface is intended to be used by client libraries only. Application developers should use OpenTelemetry API directly</strong></p>
  */
 public interface TextMapPropagator {
     /**

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/tracing/TextMapSetter.java

@@ -5,6 +5,7 @@
 
 /**
  * A {@code TextMapSetter} sets context fields on a carrier, such as {@link io.clientcore.core.http.models.HttpRequest}.
+ * <p><strong>This interface is intended to be used by client libraries only. Application developers should use OpenTelemetry API directly</strong></p>
  *
  * @param <C> the type of the carrier.
  */

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/tracing/Tracer.java

@@ -7,10 +7,7 @@
 
 /**
  * Represents a tracer - a component that creates spans.
- * <p>
- *
- * <strong>This interface is intended to be used by client libraries. Application developers
- * should use OpenTelemetry API directly</strong>
+ * <p><strong>This interface is intended to be used by client libraries only. Application developers should use OpenTelemetry API directly</strong></p>
  */
 public interface Tracer {
     /**

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/tracing/TracingScope.java

@@ -8,10 +8,8 @@
  * <p>
  *
  * The scope MUST be closed. It also MUST be closed on the same thread it was created.
- * <p>
  *
- * <strong>This interface is intended to be used by client libraries. Application developers
- * should use OpenTelemetry API directly</strong>
+ * <p><strong>This interface is intended to be used by client libraries only. Application developers should use OpenTelemetry API directly</strong></p>
  */
 @FunctionalInterface
 public interface TracingScope extends AutoCloseable {

sdk/clientcore/core/src/main/java/io/clientcore/core/telemetry/tracing/package-info.java

@@ -5,7 +5,7 @@
  * Package containing core tracing primitives to be used by client libraries.
  * <p>
  *
- * <strong>Classes in this package are not intended to be used by client libraries. Application developers
+ * <strong>Classes in this package are intended to be used by client libraries only. Application developers
  * should use OpenTelemetry API directly</strong>
  */
 package io.clientcore.core.telemetry.tracing;