Merge pull request #7217 from deeikele/projects-clarify

Clarify project docs with setup samples and capability updates

Author: v-regandowner

articles/ai-foundry/how-to/create-projects.md

@@ -20,10 +20,7 @@ ai-usage: ai-assisted
 
 # Create a project for Azure AI Foundry (Foundry projects)
 
-> [!NOTE]
-> An alternate hub project creation article is available: [Create a hub project for Azure AI Foundry](hub-create-projects.md).
-
-This article describes how to create a project in [Azure AI Foundry](https://ai.azure.com/?cid=learnDocs). Projects let you organize your work for exploring new ideas and as you prototype on a particular use case.
+This article describes how to create a project in [Azure AI Foundry](https://ai.azure.com/?cid=learnDocs). Projects let you organize your work, such as agents, evaluations, and files, as you build stateful apps and explore new ideas.
 
 [!INCLUDE [create-project-fdp](../includes/create-project-fdp.md)]
 

articles/ai-foundry/includes/create-project-fdp.md

@@ -15,17 +15,19 @@ ms.custom:
 
 * [!INCLUDE [fdp-description](../includes/fdp-description.md)]
 
-* This project type gives you the best support for:
+* This project type gives you access to the latest generative AI features in AI Foundry, including:
 
     * Agents 
-    * AI Foundry API to work with agents and across models
-    * Models sold directly by Azure - Azure OpenAI, DeepSeek, xAI, etc.
+    * Foundry SDK and API to build agents and switch easily between models
+    * Models sold directly by Azure - Azure OpenAI, Mistral, xAI, DeepSeek, etc.
     * Partner & Community Models sold through Marketplace - Stability, Bria, Cohere, etc. 
-    * Project files (directly upload files and start experimenting)
-    * Project-level isolation of files and outputs 
+    * Content understanding 
     * Evaluations
     * Fine-tuning
-    * Playgrounds
+    * OpenAI SDK and API incl. Batch and Stored Completions
+    * AI Services
+
+* Do you need access to Open Source models, or PromptFlow? [Create a hub project type](../how-to/hub-create-projects.md) instead.
 
 ## Prerequisites
 
@@ -58,7 +60,7 @@ Use the following tabs to select the method you plan to use to create a [!INCLUD
         DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
         ```
             
-    1. (Optional) If you're working on in the [Azure Government - US](/azure/azure-government/documentation-government-welcome) or [Azure China 21Vianet](https://azure.microsoft.com/global-infrastructure/services/?regions=china-east-2%2cchina-non-regional&products=all) regions, specify the region into which you want to authenticate. You can specify the region with `DefaultAzureCredential`. The following example authenticates to the Azure Government - US region:
+    1. (Optional) If you're working on in the [Azure Government - US](/azure/azure-government/documentation-government-welcome) or [Azure operated by 21Vianet](https://azure.microsoft.com/global-infrastructure/services/?regions=china-east-2%2cchina-non-regional&products=all) regions, specify the region into which you want to authenticate. You can specify the region with `DefaultAzureCredential`. The following example authenticates to the Azure Government - US region:
             
         ```python
         from azure.identity import AzureAuthorityHosts

articles/ai-foundry/includes/create-second-fdp-project.md

@@ -16,26 +16,32 @@ ms.custom:
 ---
 
 
-Create multiple [!INCLUDE [fdp-project-name](fdp-project-name.md)]s on an existing `AI Foundry` resource, so you can share your environment with your team for collaboration. 
+Create multiple [!INCLUDE [fdp-project-name](fdp-project-name.md)]s on an existing `AI Foundry` resource to enable team collaboration and shared resource access including security, deployments, and connected tools. This setup is ideal in restricted Azure subscriptions where developers need self-serve exploration ability within the setup of a pre-configured environment.
+
+:::image type="content" source="../media/how-to/projects/projects-multi-setup.png" alt-text="Diagram shows how a team could share resource access with multiple projects on a Foundry resource.":::
 
 [!INCLUDE [fdp-project-name](fdp-project-name.md)]s as Azure child resources may get assigned their own access controls, but share common settings such as network security, deployments, and Azure tool integration from their parent resource.
 
-Your first project (default project) plays a special role and has access to more features:
+While not all Foundry capabilities support organizing work in projects yet, your resource's first "default" project is more powerful. You can identify it by the tag "default" in UX experiences and the resource property "is_default" when using code options.
 
-| Feature | Default [!INCLUDE [fdp-project-name](fdp-project-name.md)] | Nondefault [!INCLUDE [fdp-project-name](fdp-project-name.md)] |
+| Feature | Default project | Other projects |
 |--|--|--|
 | Model inference | ✅ | ✅ |
 | Playgrounds | ✅ | ✅ |
 | Agents | ✅ | ✅ |
 | Evaluations | ✅ | ✅ |
+| Tracing | ✅ | ✅ |
+| Datasets | ✅ | ✅ |
+| Indexes | ✅ | ✅ |
+| Foundry SDK and API | ✅ | ✅ |
+| Content understanding | ✅ | ✅ |
+| OpenAI SDK and API | ✅ | - |
+| OpenAI Batch, Fine-tuning, Stored completions | ✅ | - |
+| Language fine-tuning | ✅ | ✅ |
+| Speech fine-tuning | ✅ | - |
 | Connections | ✅ | ✅ |
-| AI Foundry API that works with agents and across models | ✅ | ✅ |
-| Project-level isolation of files and outputs | ✅ | ✅ |
-| Azure OpenAI with Batch, StoredCompletions, Fine-tuning | ✅ |  |
-| Backwards compatible with project-less {account}.cognitiveservices.com data plane API | ✅ |  |
-| Content safety | ✅ |  |
 
-* To add a nondefault project to a resource:
+* To add a project to a Foundry resource:
 
     # [Azure AI Foundry portal](#tab/ai-foundry)
 

articles/ai-foundry/includes/fdp-description.md

@@ -11,4 +11,4 @@ ms.custom: include
 ---
 
 
-A **[!INCLUDE [fdp](fdp-project-name.md)]** is built on an Azure AI Foundry resource. This project type allows for a simple setup, access to agents, and industry leading models from OpenAI, Mistral, Meta, and more. 
+An **[!INCLUDE [fdp](fdp-project-name.md)]** is managed under an Azure AI Foundry resource. It's a container for access management, data upload and integration, and monitoring. This lets you keep your work separated between use cases without needing to create extra Azure resources.