docs: deduplicate and refine comments (#84)

Author: stainless-app[bot]

openlayer-java-client-okhttp/src/main/kotlin/com/openlayer/api/client/okhttp/OpenlayerOkHttpClient.kt

@@ -146,6 +146,7 @@ class OpenlayerOkHttpClient private constructor() {
 
         fun apiKey(apiKey: String?) = apply { clientOptions.apiKey(apiKey) }
 
+        /** Alias for calling [Builder.apiKey] with `apiKey.orElse(null)`. */
         fun apiKey(apiKey: Optional<String>) = apiKey(apiKey.getOrNull())
 
         fun fromEnv() = apply { clientOptions.fromEnv() }

openlayer-java-client-okhttp/src/main/kotlin/com/openlayer/api/client/okhttp/OpenlayerOkHttpClientAsync.kt

@@ -148,6 +148,7 @@ class OpenlayerOkHttpClientAsync private constructor() {
 
         fun apiKey(apiKey: String?) = apply { clientOptions.apiKey(apiKey) }
 
+        /** Alias for calling [Builder.apiKey] with `apiKey.orElse(null)`. */
         fun apiKey(apiKey: Optional<String>) = apiKey(apiKey.getOrNull())
 
         fun fromEnv() = apply { clientOptions.fromEnv() }

openlayer-java-core/src/main/kotlin/com/openlayer/api/core/ClientOptions.kt

@@ -94,6 +94,7 @@ private constructor(
 
         fun apiKey(apiKey: String?) = apply { this.apiKey = apiKey }
 
+        /** Alias for calling [Builder.apiKey] with `apiKey.orElse(null)`. */
         fun apiKey(apiKey: Optional<String>) = apiKey(apiKey.getOrNull())
 
         fun headers(headers: Headers) = apply {

openlayer-java-core/src/main/kotlin/com/openlayer/api/core/Timeout.kt

@@ -90,13 +90,7 @@ private constructor(
          */
         fun connect(connect: Duration?) = apply { this.connect = connect }
 
-        /**
-         * The maximum time allowed to establish a connection with a host.
-         *
-         * A value of [Duration.ZERO] means there's no timeout.
-         *
-         * Defaults to `Duration.ofMinutes(1)`.
-         */
+        /** Alias for calling [Builder.connect] with `connect.orElse(null)`. */
         fun connect(connect: Optional<Duration>) = connect(connect.getOrNull())
 
         /**
@@ -108,13 +102,7 @@ private constructor(
          */
         fun read(read: Duration?) = apply { this.read = read }
 
-        /**
-         * The maximum time allowed between two data packets when waiting for the server’s response.
-         *
-         * A value of [Duration.ZERO] means there's no timeout.
-         *
-         * Defaults to `request()`.
-         */
+        /** Alias for calling [Builder.read] with `read.orElse(null)`. */
         fun read(read: Optional<Duration>) = read(read.getOrNull())
 
         /**
@@ -126,13 +114,7 @@ private constructor(
          */
         fun write(write: Duration?) = apply { this.write = write }
 
-        /**
-         * The maximum time allowed between two data packets when sending the request to the server.
-         *
-         * A value of [Duration.ZERO] means there's no timeout.
-         *
-         * Defaults to `request()`.
-         */
+        /** Alias for calling [Builder.write] with `write.orElse(null)`. */
         fun write(write: Optional<Duration>) = write(write.getOrNull())
 
         /**
@@ -147,16 +129,7 @@ private constructor(
          */
         fun request(request: Duration?) = apply { this.request = request }
 
-        /**
-         * The maximum time allowed for a complete HTTP call, not including retries.
-         *
-         * This includes resolving DNS, connecting, writing the request body, server processing, as
-         * well as reading the response body.
-         *
-         * A value of [Duration.ZERO] means there's no timeout.
-         *
-         * Defaults to `Duration.ofMinutes(1)`.
-         */
+        /** Alias for calling [Builder.request] with `request.orElse(null)`. */
         fun request(request: Optional<Duration>) = request(request.getOrNull())
 
         fun build(): Timeout = Timeout(connect, read, write, request)