chore: Improve the javadoc for getOtel()

lqiu96 · lqiu96 · commit 853913acbedd · 2026-04-30T16:15:50.000-04:00
diff --git a/java-datastore/google-cloud-datastore/src/main/java/com/google/cloud/datastore/DatastoreOpenTelemetryOptions.java b/java-datastore/google-cloud-datastore/src/main/java/com/google/cloud/datastore/DatastoreOpenTelemetryOptions.java
@@ -91,9 +91,11 @@ public boolean isExportBuiltinMetricsToGoogleCloudMonitoring() {
   }
 
   /**
-   * Returns the custom {@link OpenTelemetry} instance, if one was provided.
+   * Returns the configured custom {@link OpenTelemetry} instance.
    *
-   * @return the custom {@link OpenTelemetry} instance.
+   * @return the configured {@link OpenTelemetry} instance, or the global instance if a custom one
+   *     was not provided. If there is no global instance, then {@code OpenTelemetry.noop()} is
+   *     returned.
    */
   @Nonnull
   public OpenTelemetry getOpenTelemetry() {

Original file line number	Diff line number	Diff line change
`@@ -91,9 +91,11 @@ public boolean isExportBuiltinMetricsToGoogleCloudMonitoring() {`
`91`	`91`	`}`
`92`	`92`
`93`	`93`	`/**`
`94`		`- * Returns the custom {@link OpenTelemetry} instance, if one was provided.`
	`94`	`+ * Returns the configured custom {@link OpenTelemetry} instance.`
`95`	`95`	`*`
`96`		`- * @return the custom {@link OpenTelemetry} instance.`
	`96`	`+ * @return the configured {@link OpenTelemetry} instance, or the global instance if a custom one`
	`97`	`+ * was not provided. If there is no global instance, then {@code OpenTelemetry.noop()} is`
	`98`	`+ * returned.`
`97`	`99`	`*/`
`98`	`100`	`@Nonnull`
`99`	`101`	`public OpenTelemetry getOpenTelemetry() {`