chore: Update docs

README.md

@@ -47,6 +47,11 @@ The following table lists the required versions, based on the latest release:
 
 See [an example `pom.xml` in our Spring Boot application](sample-code/spring-app/pom.xml).
 
+> [!WARNING]  
+> All classes under any of the `...model` packages are generated from an OpenAPI specification and marked as `@Beta`.
+> This means that these model classes are not guaranteed to be stable and may change with future releases.
+> They are safe to use, but may require updates even in minor releases.
+
 ## Getting Started
 
 ### What You'll Build
@@ -130,6 +135,8 @@ For more detailed information and advanced usage, please refer to the following:
 - [OpenAI Chat Completion](docs/guides/OPENAI_CHAT_COMPLETION.md)
 - [AI Core Deployment](docs/guides/AI_CORE_DEPLOYMENT.md)
 
+For updating versions, please refer to the [**Release Notes**](docs/release-notes/release-notes-0-to-14.md).
+
 ## FAQs
 
 ### _"How to add a custom header to AI Core requests?"_

docs/guides/AI_CORE_DEPLOYMENT.md

@@ -13,6 +13,10 @@
 
 This guide provides examples on how to create and manage deployments in SAP AI Core using the SAP AI SDK for Java.
 
+> [!WARNING]  
+> The below examples rely on generated model classes.
+> Please be aware of the [implications described here](/README.md#general-requirements).
+
 ## Prerequisites
 
 Before using the AI Core module, ensure that you have met all the general requirements outlined in the [README.md](../../README.md#general-requirements).

docs/guides/CONNECTING_TO_AICORE.md

@@ -116,14 +116,18 @@ You can define a destination in the BTP Destination Service and use that to conn
   - **Client ID**: `[clientid]`
   - **Client Secret**: `[clientsecret]`
   - **Token Service URL Type**: `Dedicated`
-  - **Token Service URL**: `[url]`
+  - **Token Service URL**: `[url]/oauth/token`
   
     Fill in the values for URL, client ID, client secret, and token service URL from the service key JSON.
+    Make sure to add `/oauth/token` in the token service URL.
 
 </details>
 
 To use the destination, ensure you have created an instance of the BTP Destination Service and bound it to your application.
 
+> [!Tip]
+> If you are using CAP, you can again use Hybrid Testing to bind the destination service to your application when running **locally**.
+
 ```java
 Destination destination = DestinationAccessor.getDestination("my-aicore").asHttp();
 AiCoreService aiCoreService = new AiCoreService().withBaseDestination(destination);