Update documentation

README.md

@@ -69,6 +69,7 @@ The SDK provides a unified Java interface to the watsonx.ai ecosystem and works
 | **[Rerank](https://ibm.github.io/watsonx-ai-java-sdk/services/rerank-service/)** | Relevance scoring and reordering of candidate documents |
 | **[Time Series](https://ibm.github.io/watsonx-ai-java-sdk/services/time-series-service/)** | Time series forecasting using IBM Granite TTM models |
 | **[Deployment](https://ibm.github.io/watsonx-ai-java-sdk/services/deployment-service/)** | Chat and forecasting via deployed model endpoints |
+| **[Foundation Model](https://ibm.github.io/watsonx-ai-java-sdk/services/foundation-model-service/)** | Browse and query the watsonx.ai model catalog |
 
 ### Model Gateway
 
@@ -96,7 +97,6 @@ Proxy layer that routes requests to third-party foundation models (OpenAI, Anthr
 | **[Tool](https://ibm.github.io/watsonx-ai-java-sdk/services/tool-service/)** | Server-side utility tools for agentic workflows |
 | **[Tokenization](https://ibm.github.io/watsonx-ai-java-sdk/services/tokenization-service/)** | Token counting and analysis for any model |
 | **[Detection](https://ibm.github.io/watsonx-ai-java-sdk/services/detection-service/)** | Identification of harmful content (HAP), PII, and safety violations |
-| **[Foundation Model](https://ibm.github.io/watsonx-ai-java-sdk/services/foundation-model-service/)** | Browse and query the watsonx.ai model catalog |
 | **[File](https://ibm.github.io/watsonx-ai-java-sdk/services/file-service/)** | Upload, list, and retrieve files for use in batch processing jobs |
 | **[Batch](https://ibm.github.io/watsonx-ai-java-sdk/services/batch-service/)** | High-volume asynchronous inference from JSONL input files |
 

docs/content/index.mdx

@@ -63,6 +63,7 @@ System.out.println(response.content());
 | **[Rerank](services/rerank-service)** | Score and sort a list of candidate passages against a query |
 | **[Time Series](services/time-series-service)** | Forecast time series data using IBM Granite TTM models |
 | **[Deployment](services/deployment-service)** | Target a deployed model by `deploymentId` for chat and forecasting |
+| **[Foundation Model](services/foundation-model-service)** | Browse the model catalog - filter by provider, task, function, lifecycle |
 
 ### Model Gateway
 
@@ -93,13 +94,12 @@ Proxy layer that routes requests to third-party foundation models (OpenAI, Anthr
 | **[Tool](services/tool-service)** | Invoke IBM-hosted utility tools (search, weather, Python interpreter, RAG) |
 | **[Tokenization](services/tokenization-service)** | Count tokens and retrieve the individual token strings for a given model |
 | **[Detection](services/detection-service)** | Detect harmful content (HAP), PII, and safety violations |
-| **[Foundation Model](services/foundation-model-service)** | Browse the model catalog - filter by provider, task, function, lifecycle |
 | **[File](services/file-service)** | Upload, list, retrieve, and delete files used as batch job inputs |
 | **[Batch](services/batch-service)** | Submit high-volume asynchronous inference jobs from JSONL files |
 
 ## Framework integrations
 
-The SDK integrates with popular LLM application frameworks:
+The SDK integrates seamlessly with popular Java frameworks:
 
 - [LangChain4j](https://docs.langchain4j.dev/)
 - [Quarkus LangChain4j](https://docs.quarkiverse.io/quarkus-langchain4j/dev/index.html)

docs/content/services/index.md

@@ -17,6 +17,7 @@ Every service in the SDK follows the same **builder pattern**: configure it once
 | **[Time Series](time-series-service)** | Forecast time series data using IBM Granite TTM models |
 | **[Deployment](deployment-service)** | Target a deployed model by `deploymentId` for chat and forecasting |
 | **[Model Gateway](model-gateway)** | Chat with third-party models (OpenAI, Anthropic, etc.) via a unified IBM-managed gateway |
+| **[Foundation Model](foundation-model-service)** | Browse the model catalog - filter by provider, task, function, lifecycle |
 
 ## Document processing
 
@@ -37,6 +38,5 @@ These services read from and write to **IBM Cloud Object Storage (COS)**. A `CON
 | **[Tool](tool-service)** | Invoke IBM-hosted utility tools (search, weather, Python interpreter, RAG) |
 | **[Tokenization](tokenization-service)** | Count tokens and retrieve the individual token strings for a given model |
 | **[Detection](detection-service)** | Detect harmful content (HAP), PII, and safety violations |
-| **[Foundation Model](foundation-model-service)** | Browse the model catalog - filter by provider, task, function, lifecycle |
 | **[File](file-service)** | Upload, list, retrieve, and delete files used as batch job inputs |
 | **[Batch](batch-service)** | Submit high-volume asynchronous inference jobs from JSONL files |