docs: async and sync method comments (#167)

Author: stainless-app[bot]

openai-java-core/src/main/kotlin/com/openai/client/OpenAIClient.kt

@@ -30,6 +30,12 @@ import com.openai.services.blocking.UploadService
  */
 interface OpenAIClient {
 
+    /**
+     * Returns a version of this client that uses asynchronous execution.
+     *
+     * The returned client shares its resources, like its connection pool and thread pools, with
+     * this client.
+     */
     fun async(): OpenAIClientAsync
 
     fun completions(): CompletionService

openai-java-core/src/main/kotlin/com/openai/client/OpenAIClientAsync.kt

@@ -30,6 +30,12 @@ import com.openai.services.async.UploadServiceAsync
  */
 interface OpenAIClientAsync {
 
+    /**
+     * Returns a version of this client that uses synchronous execution.
+     *
+     * The returned client shares its resources, like its connection pool and thread pools, with
+     * this client.
+     */
     fun sync(): OpenAIClient
 
     fun completions(): CompletionServiceAsync