update javadoc

Author: Duncan-tree-zhou

Diff for: instrumentation-annotations-incubator/src/main/java/io/opentelemetry/instrumentation/annotations/incubator/Counted.java

@@ -37,7 +37,7 @@
   /**
    * Name of the Counter metric.
    *
-   * <p>The name should follow the metric naming rule: <a
+   * <p>The name should follow the metric naming rules: <a
    * href="https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/metrics/api.md#instrument-name-syntax">https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/metrics/api.md#instrument-name-syntax</a>
    */
   String value();

Diff for: instrumentation-annotations-incubator/src/main/java/io/opentelemetry/instrumentation/annotations/incubator/StaticAttribute.java

@@ -12,11 +12,11 @@
 import java.lang.annotation.Target;
 
 /**
- * This annotation allows for adding attributes to the metrics recorded using {@link Timed} and
- * {@link Counted} annotations.
+ * This annotation allows for adding static attributes to the metrics recorded using {@link Timed}
+ * and {@link Counted} annotations.
  *
  * <p>Application developers can use this annotation to signal OpenTelemetry auto-instrumentation
- * that the attribute should be created.
+ * that the static attributes should be captured.
  *
  * <p>If you are a library developer, then probably you should NOT use this annotation, because it
  * is non-functional without the OpenTelemetry auto-instrumentation agent, or some other annotation
@@ -27,9 +27,9 @@
 @Repeatable(StaticAttributes.class)
 public @interface StaticAttribute {
 
-  /** Name of the attribute. */
+  /** Name of the static attribute. */
   String name();
 
-  /** Value of the attribute. */
+  /** Value of the static attribute. */
   String value();
 }

Diff for: instrumentation-annotations-incubator/src/main/java/io/opentelemetry/instrumentation/annotations/incubator/StaticAttributes.java

@@ -11,11 +11,11 @@
 import java.lang.annotation.Target;
 
 /**
- * This annotation allows for adding attributes to the metrics recorded using {@link Timed} and
- * {@link Counted} annotations.
+ * This annotation allows for adding static attributes to the metrics recorded using {@link Timed}
+ * and {@link Counted} annotations.
  *
  * <p>Application developers can use this annotation to signal OpenTelemetry auto-instrumentation
- * that the attribute should be created.
+ * that the static attributes should be captured.
  *
  * <p>If you are a library developer, then probably you should NOT use this annotation, because it
  * is non-functional without the OpenTelemetry auto-instrumentation agent, or some other annotation
@@ -25,6 +25,6 @@
 @Retention(RetentionPolicy.RUNTIME)
 public @interface StaticAttributes {
 
-  /** Array of {@link StaticAttribute} annotations describing the added attributes. */
+  /** Array of {@link StaticAttribute} annotations describing the attributes to capture. */
   StaticAttribute[] value();
 }

Diff for: instrumentation-annotations-incubator/src/main/java/io/opentelemetry/instrumentation/annotations/incubator/Timed.java

@@ -38,7 +38,7 @@
   /**
    * Name of the Histogram metric.
    *
-   * <p>The name should follow the metric naming rule: <a
+   * <p>The name should follow the metric naming rules: <a
    * href="https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/metrics/api.md#instrument-naming-rule">https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/metrics/api.md#instrument-naming-rule</a>
    */
   String value();