Fixing docs formatting, sample messages and release notes module tagging

Author: rpanackal

docs/guides/OPENAI_CHAT_COMPLETION.md

@@ -129,8 +129,8 @@ OpenAiClient.withCustomDestination(destination);
 ```java
 var request =
     new OpenAiChatCompletionRequest(
-        OpenAiMessage.system("I'm fine, thank you!"),
-        OpenAiMessage.user("Hello, how are you?"));
+        OpenAiMessage.system("You are a helpful assistant"),
+        OpenAiMessage.user("Hello World! Why is this phrase so famous?"));
 
 var response = OpenAiClient.forModel(GPT_4O).chatCompletion(request).getContent();
 ```
@@ -203,8 +203,7 @@ try (Stream<String> stream = client.streamChatCompletion(msg)) {
 
 **Since v1.4.0**
 
-The following example demonstrate how you can leverage a concurrency-safe container (like an AtomicReference) to "listen" for usage information in
-any incoming delta.
+The following example demonstrate how you can leverage a concurrency-safe container (like an AtomicReference) to "listen" for usage information in any incoming delta.
 
 ```java
 String question = "Can you give me the first 100 numbers of the Fibonacci sequence?";
@@ -233,7 +232,8 @@ Thread streamProcessor =
 
 // Start the processing thread; the main thread remains free (non-blocking)
 streamProcessor.start();
-streamProcessor.join(); // Wait for the thread to finish (blocking)
+// Wait for the thread to finish (blocking)
+streamProcessor.join();
 
 // Access information caught from completion usage
 Integer tokensUsed = usageRef.get().getCompletionTokens();

docs/release-notes/release_notes.md

@@ -10,20 +10,21 @@
 
 - [Orchestration] The constructors `UserMessage(MessageContent)` and `SystemMessage(MessageContent)` are removed. Use `Message.user(String)`, `Message.user(ImageItem)`, or `Message.system(String)` instead.
 - Deprecate `getCustomField(String)` in favor of `toMap()` on generated model classes.
-  - `com.sap.ai.sdk.core.model.*`
-  - `com.sap.ai.sdk.orchestration.model.*`
+    - `com.sap.ai.sdk.core.model.*`
+    - `com.sap.ai.sdk.orchestration.model.*`
 
 ### ✨ New Functionality
 
 - [Orchestration] [Add Spring AI tool calling](../guides/SPRING_AI_INTEGRATION.md#tool-calling).
 - [Document Grounding] [Add Document Grounding Client](https://github.com/SAP/ai-sdk-java/tree/main/docs/guides/GROUNDING.md)
     - `com.sap.ai.sdk:document-grounding:1.4.0`
-- [OpenAI] New generated model classes introduced for _AzureOpenAI_ specification dated 2024-10-21.
-- [OpenAI] Introducing [new user interface](../guides/OPENAI_CHAT_COMPLETION.md/#new-user-interface-v140) for chat completion wrapping the generated model classes.
-  - `OpenAiChatCompletionRequest` and `OpenAiChatCompletionResponse`' for high level request and response handling.
-  - `OpenAiUserMessage`, `OpenAiSystemMessage`, `OpenAiAssistantMessage` and `OpenAiToolMessage` for message creation for different content types.
-  - `OpenAiToolChoice` for configuring chat completion requests with tool selection strategy.
-- [OpenAI] Introducing new user interface for embedding calls using `OpenAiEmbeddingRequest` and `OpenAiEmbeddingResponse`.
+- [OpenAI]
+    - New generated model classes introduced for _AzureOpenAI_ specification dated 2024-10-21.
+    - Introducing [new user interface](../guides/OPENAI_CHAT_COMPLETION.md/#new-user-interface-v140) for chat completion wrapping the generated model classes.
+        - `OpenAiChatCompletionRequest` and `OpenAiChatCompletionResponse`' for high level request and response handling.
+        - `OpenAiUserMessage`, `OpenAiSystemMessage`, `OpenAiAssistantMessage` and `OpenAiToolMessage` for message creation for different content types.
+        - `OpenAiToolChoice` for configuring chat completion requests with tool selection strategy.
+    - Introducing new user interface for embedding calls using `OpenAiEmbeddingRequest` and `OpenAiEmbeddingResponse`.
 
 ### 📈 Improvements