Minor cosmetic fix

Author: rpanackal

foundation-models/openai/src/main/java/com/sap/ai/sdk/foundationmodels/openai/OpenAiClient.java

@@ -186,6 +186,22 @@ public OpenAiChatCompletionResponse chatCompletion(
     return chatCompletion(request.toCreateChatCompletionRequest());
   }
 
+  /**
+   * Generate a completion for the given conversation and request parameters.
+   *
+   * @param parameters the completion request.
+   * @return the completion output
+   * @throws OpenAiClientException if the request fails
+   * @deprecated Use {@link #chatCompletion(OpenAiChatCompletionRequest)} instead.
+   */
+  @Deprecated(since = "1.3.0")
+  @Nonnull
+  public OpenAiChatCompletionOutput chatCompletion(
+      @Nonnull final OpenAiChatCompletionParameters parameters) throws OpenAiClientException {
+    warnIfUnsupportedUsage();
+    return execute("/chat/completions", parameters, OpenAiChatCompletionOutput.class);
+  }
+
   /**
    * Stream a completion for the given string prompt as user.
    *
@@ -208,7 +224,7 @@ public OpenAiChatCompletionResponse chatCompletion(
    * Stream#parallel()} on this stream is not supported.
    *
    * @param prompt a text message.
-   * @return A stream of message deltas
+   * @return A stream of text chunks
    * @throws OpenAiClientException if the request fails or if the finish reason is content_filter
    * @see #streamChatCompletionDeltas(OpenAiChatCompletionRequest)
    */
@@ -227,22 +243,6 @@ public Stream<String> streamChatCompletion(@Nonnull final String prompt)
         .map(OpenAiChatCompletionDelta::getDeltaContent);
   }
 
-  /**
-   * Generate a completion for the given conversation and request parameters.
-   *
-   * @param parameters the completion request.
-   * @return the completion output
-   * @throws OpenAiClientException if the request fails
-   * @deprecated Use {@link #chatCompletion(OpenAiChatCompletionRequest)} instead.
-   */
-  @Deprecated(since = "1.3.0")
-  @Nonnull
-  public OpenAiChatCompletionOutput chatCompletion(
-      @Nonnull final OpenAiChatCompletionParameters parameters) throws OpenAiClientException {
-    warnIfUnsupportedUsage();
-    return execute("/chat/completions", parameters, OpenAiChatCompletionOutput.class);
-  }
-
   /**
    * Stream a completion for the given conversation and request parameters.
    *
@@ -285,6 +285,7 @@ public Stream<OpenAiChatCompletionDelta> streamChatCompletionDeltas(
    * @param request The completion request.
    * @return A stream of message deltas
    * @throws OpenAiClientException if the request fails or if the finish reason is content_filter
+   * @see #streamChatCompletionDeltas(OpenAiChatCompletionRequest) for a higher-level API
    */
   @Nonnull
   public Stream<OpenAiChatCompletionDelta> streamChatCompletionDeltas(
@@ -305,7 +306,7 @@ public Stream<OpenAiChatCompletionDelta> streamChatCompletionDeltas(
    * <p>Example:
    *
    * <pre>{@code
-   * try (var stream = client.streamChatCompletionDeltas(prompt)) {
+   * try (var stream = client.streamChatCompletionDeltas(request)) {
    *       stream
    *           .peek(delta -> System.out.println(delta.getUsage()))
    *           .map(com.sap.ai.sdk.foundationmodels.openai.model.OpenAiChatCompletionDelta::getDeltaContent)