Merge pull request #6610 from sdgilley/sdg-updates

UUF - articles/ai-foundry/how-to/develop/sdk-overview.md

Author: prmerger-automator[bot]

articles/ai-foundry/how-to/develop/sdk-overview.md

@@ -6,8 +6,9 @@ ms.service: azure-ai-foundry
 ms.custom:
   - build-2024
   - ignite-2024
+ai-usage: ai-assisted
 ms.topic: how-to
-ms.date: 07/01/2025
+ms.date: 08/15/2025
 ms.reviewer: dantaylo
 ms.author: sgilley
 author: sdgilley
@@ -41,6 +42,10 @@ The Azure AI Foundry SDK is a set of client libraries and services designed to w
 
 ## Unified Projects client library
 
+The following examples show how to connect to your Azure AI Foundry project using different programming languages. This connection is the first step to accessing models, data, and AI services through the SDK. Each code block demonstrates how to authenticate and create a client for your project endpoint.
+
+> [!TIP]
+> The code samples below are starting points. You’ll use these clients to interact with models, run evaluations, and more, as described in the client libraries section below.
 
 
 ::: zone pivot="programming-language-python"
@@ -62,6 +67,7 @@ The [Azure AI Foundry Projects client library for Python](/python/api/overview/a
     project = AIProjectClient(
       endpoint="your_project_endpoint",  # Replace with your endpoint
       credential=DefaultAzureCredential())
+    # The AIProjectClient lets you access models, data, and services in your project.
     ```
 ::: zone-end
 
@@ -88,6 +94,7 @@ The [Azure AI Foundry Projects client library for Java (preview)](/java/api/over
         .credential(new DefaultAzureCredential())
         .endpoint(endpoint)
         .buildClient();
+    // The ProjectsClient enables unified access to your project's resources.
     ```
 
 
@@ -113,6 +120,7 @@ The [Azure AI Foundry Projects client library for JavaScript](/javascript/api/ov
     
     const endpoint = "your_project_endpoint"; // Replace with your actual endpoint
     const project = new AIProjectClient(endpoint, new DefaultAzureCredential());
+    // The AIProjectClient lets you access models, data, and services in your project.
     ```
 
 
@@ -147,16 +155,20 @@ The [Azure AI Foundry Projects client library for .NET](/dotnet/api/overview/azu
         credential, 
         new string[] { "https://cognitiveservices.azure.com/.default" }
     );
+    // The PerRetry position ensures the authentication policy is applied to every retry attempt.
+    // This is important for robust authentication in distributed/cloud environments.
     clientOptions.AddPolicy(tokenPolicy, HttpPipelinePosition.PerRetry);
     
     var projectClient = new ChatCompletionsClient(
         endpointUrl, 
         credential,
         clientOptions
     );
+    // The ChatCompletionsClient lets you interact with models and services in your project.
     ```
 
 ::: zone-end
+After you create a client, you can use it to access models, run evaluations, and connect to other AI services. The next section lists the available client libraries and shows how to use them for specific Azure AI services.
 
 <a name="azure-ai-foundry-agent-service"></a>
 * Using the project endpoint, you can: