Merge pull request #5545 from sdgilley/sdg-patches

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

Author: prmerger-automator[bot]

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

@@ -21,7 +21,7 @@ zone_pivot_groups: project-type
 
 # Create a project for Azure AI Foundry
 
-This article describes how to create an [Azure AI Foundry](https://ai.azure.com/?cid=learnDocs) project. 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 for exploring new ideas and as you prototype on a particular use case.
 
 Azure AI Foundry supports two types of projects: a **[!INCLUDE [fdp](../includes/fdp-project-name.md)]** and a **[!INCLUDE [hub](../includes/hub-project-name.md)]**. For more information about the differences between these two project types, see [Types of projects](../what-is-azure-ai-foundry.md#project-types).
 

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

@@ -20,16 +20,15 @@ ms.custom:
 
 * This project type gives you the best support for:
 
-    * Agents
-    * AI Model Inference including Azure OpenAI	
-    * AI Foundry API that works with agents and across models	
+    * Agents 
+    * AI Foundry API to work with agents and across models
+    * Models sold directly by Azure - Azure OpenAI, DeepSeek, xAI, etc.
+    * Partner & Community Models sold through Marketplace - Stability, Bria, Cohere, etc. 
     * Project files (directly upload files and start experimenting)
     * Evaluations
     * Fine-tuning
     * Playgrounds
 
-* You can also [Use a Bicep file](../how-to/create-azure-ai-project-template.md) to create a [!INCLUDE [fdp-project-name](fdp-project-name.md)].
-
 
 ## Prerequisites
 
@@ -38,7 +37,7 @@ Use the following tabs to select the method you plan to use to create a [!INCLUD
 # [Azure AI Foundry portal](#tab/ai-foundry)
 
 - An Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/).
-- You must be **Owner** of the subscription to receive the appropriate access control needed to use the project.
+- You must be **Owner** of the subscription to have appropriate access control necessary to create the Azure AI Foundry resource that is the parent of the project.  If you don't have this access, have your administrator [create an AI Foundry resource](../../ai-services/multi-service-resource.md) for you to use.  Then skip to [Create multiple projects on the same resource](#create-multiple) to create your project.
 
 
 # [Python SDK](#tab/python)
@@ -47,6 +46,26 @@ Use the following tabs to select the method you plan to use to create a [!INCLUD
 - You must be **Owner** of the subscription to receive the appropriate access control needed to use the project.
 - [Set up your development environment](../how-to/develop/install-cli-sdk.md?tabs=python)
 - Authenticate with `az login` or `az login --use-device-code` in your environment before running code.
+- Complete these steps to start your Python script:
+    1. Install packages: `pip install azure-identity azure-mgmt-cognitiveservices`. If in a notebook cell, use `%pip install azure-identity azure-mgmt-cognitiveservices`.
+    1. Use `pip show azure-mgmt-cognitiveservices` to verify your version is 13.7 or greater.
+    1. Start your script with the following code to create the `client` connection and variables used throughout this article.  This example creates the project in West US:
+    
+        ```python
+        from azure.identity import DefaultAzureCredential
+        from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
+        
+        sub_id = 'your-sub'
+        rgp = 'your-resource-group'
+        resource_name = 'your-resource'
+        project_name = 'your-project'
+        location = 'westus'
+        
+        client = CognitiveServicesManagementClient(
+            credential=DefaultAzureCredential(), 
+            subscription_id=sub_id,
+            api_version="2025-04-01-preview"
+        )
 
 
 # [Azure CLI](#tab/azurecli)
@@ -61,6 +80,13 @@ Use the following tabs to select the method you plan to use to create a [!INCLUD
 
 # [Azure AI Foundry portal](#tab/ai-foundry)
 
+These steps provide a way to create a new Azure resource with basic, defaulted, settings. 
+
+> [!TIP]
+> If your organization requires customized Azure configurations like alternative names, security controls or cost tags, use one of these methods instead to comply with your organization's Azure Policy compliance:
+> * [Create your first AI Foundry resource](../../ai-services/multi-service-resource.md) 
+> * [Create an Azure AI Foundry resource using a Bicep file](../how-to/create-resource-template.md) 
+
 To create a [!INCLUDE [fdp-project-name](fdp-project-name.md)] in [Azure AI Foundry](https://ai.azure.com/?cid=learnDocs), follow these steps:
 
 1. Sign in to [Azure AI Foundry](https://ai.azure.com/?cid=learnDocs).
@@ -91,27 +117,11 @@ To customize the settings for your project, follow these steps:
 
 To create a [!INCLUDE [fdp](../includes/fdp-project-name.md)]:
 
-1. Install packages: `pip install azure-identity azure-mgmt-cognitiveservices`. If in a notebook cell, use `%pip install azure-identity azure-mgmt-cognitiveservices`.
-1. Use `pip show azure-mgmt-cognitiveservices` to verify your version is 13.7 or greater.
-1. Use the following code to create a [!INCLUDE [fdp-project-name](../includes/fdp-project-name.md)].  This example creates the project in West US:
+
+1. Add this code to create a [!INCLUDE [fdp-project-name](../includes/fdp-project-name.md)], using the variables and `client` connection from the [Prerequisites](#prerequisites).
 
     ```python
-    from azure.identity import DefaultAzureCredential
-    from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
-    import os
-    import json
-    
-    sub_id = 'your-sub'
-    rgp = 'your-resource-group'
-    resource_name = 'your-resource'
-    project_name = 'your-project'
-    location = 'westus'
-    
-    client = CognitiveServicesManagementClient(
-        credential=DefaultAzureCredential(), 
-        subscription_id=sub_id,
-        api_version="2025-04-01-preview"
-    )
+
     # Create resource
     resource = client.accounts.begin_create(
         resource_group_name=rgp,
@@ -177,7 +187,7 @@ CLI commands not currently available for creating a [!INCLUDE [fdp-project-name]
 
 ---
 
-## Create multiple projects on the same resource
+## <a name="create-multiple"></a> Create multiple projects on the same resource
 
 [!INCLUDE [create-second-fdp-project](create-second-fdp-project.md)]
 

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

@@ -51,20 +51,20 @@ Your first project (default project) plays a special role and has access to more
 
     # [Python SDK](#tab/python)
 
+    Add this code to your script to create a new project on your existing 
+
     ```python
     new_project_name = 'your-new-project-name'
 
     project = client.projects.begin_create(
-      resource_group_name=resource_group_name,
-      account_name=foundry_resource_name,
-      project_name=new_project_name,
-      project={
-          "location": location,
-          "identity": {
-              "type": "SystemAssigned"
-          },
-          "properties": {}
-      }
+        resource_group_name=rgp,
+        account_name=resource_name,
+        project_name=new_project_name,
+        project={
+            "location": location,
+            "identity": {"type": "SystemAssigned"},
+            "properties": {}
+        }
     )
     ```