Add documentation and release notes

Author: Jonas-Isr

docs/guides/ORCHESTRATION_CHAT_COMPLETION.md

@@ -259,6 +259,39 @@ try (Stream<String> stream = client.streamChatCompletion(prompt, config)) {
 Please find [an example in our Spring Boot application](../../sample-code/spring-app/src/main/java/com/sap/ai/sdk/app/services/OrchestrationService.java).
 It shows the usage of Spring Boot's `ResponseBodyEmitter` to stream the chat completion delta messages to the frontend in real-time.
 
+
+## Add images and multiple text inputs to a message
+
+It's possible to add images and multiple text inputs to a message.
+
+### Add images to a message
+
+There are multiple ways to add an image to a user message as detailed below. Note, that currently only user messages are supported for image attachments.
+
+```java
+var message1 = Message.user("What is in this image?").addImage("https://url.to/image.jpg");
+var message2 = Message.user("And what is in this image?").add(MessageContent.image("https://url.to/image.jpg"));
+```
+Some AI models, like GPT 4o, support additionally setting the detail level with which the image is read. This can be set via the `DetailLevel` parameter.
+
+```java
+message.addImage("https://url.to/image.jpg", ImageItem.DetailLevel.low);
+```
+
+### Add multiple text inputs to a message
+
+It's also possible to add multiple text inputs to a message. This can be useful for providing additional context to the AI model.
+There are multiple ways to do this as detailed below. Note, that only user and system messages are supported for multiple text inputs.
+
+```java
+var message1 = Message.user("What is chess about?", "Answer in two sentences.");
+var message2 = Message.user("What is chess about?").addText("Answer in two sentences.");
+var message3 = Message.user("What is chess about?").add(MessageContent.text("Answer in two sentences."));
+```
+
+Please find [an example in our Spring Boot application](../../sample-code/spring-app/src/main/java/com/sap/ai/sdk/app/services/OrchestrationService.java).
+
+
 ## Set model parameters
 
 Change your LLM configuration to add model parameters:

docs/release-notes/release_notes.md

@@ -8,11 +8,12 @@
 
 ### 🔧 Compatibility Notes
 
--
+- `Message.content()` returns a `ContentItem` now instead of a `String`. Use `((TextItem) Message.content().contentItemList().get(0)).text()` if the corresponding `ContentItem` is a `TextItem` and the string representation is needed.
 
 ### ✨ New Functionality
 
 - [Add Orchestration `LlamaGuardFilter`](../guides/ORCHESTRATION_CHAT_COMPLETION.md#chat-completion-filter).
+- [Convenient methods to create messages containing images and multiple text inputs](../guides/ORCHESTRATION_CHAT_COMPLETION.md#add-images-and-multiple-text-inputs-to-a-message)
 
 ### 📈 Improvements