edit pass: azure-openai-on-your-data

Author: ShawnJackson

articles/ai-services/openai/concepts/use-your-image-data.md

@@ -1,6 +1,6 @@
 ---
 title: 'Use your image data with Azure OpenAI Service in Azure OpenAI Studio'
-titleSuffix: Azure OpenAI
+titleSuffix: Azure OpenAI Service
 description: Use this article to learn about using your image data for image generation in Azure OpenAI.
 services: cognitive-services
 manager: nitinme
@@ -12,7 +12,7 @@ ms.date: 05/09/2024
 recommendations: false
 ---
 
-# Azure OpenAI on your data with images using GPT-4 Turbo with Vision (preview) in Azure OpenAI Studio
+# Use your image data for Azure OpenAI by using GPT-4 Turbo with Vision (preview) in Azure OpenAI Studio
 
 Use this article to learn how to provide your own image data for GPT-4 Turbo with Vision, the vison model in Azure OpenAI Service. GPT-4 Turbo with Vision on your data allows the model to generate more customized and targeted answers by using Retrieval Augmented Generation (RAG), based on your own images and image metadata.
 
@@ -52,7 +52,7 @@ All three options use an Azure AI Search index to do an image-to-image search an
 
 When you're adding a data source for the first time, you might see a red notice that asks you to turn on cross-origin resource sharing (CORS). To stop the warning, select **Turn on CORS** so that Azure OpenAI can access the data source.
 
-:::image type="content" source="../media/use-your-image-data/cross-origin-resource-sharing-requirement.png" alt-text="Screenshot that shows an error stating that CORS has not been enabled." lightbox="../media/use-your-image-data/cross-origin-resource-sharing-requirement.png":::
+:::image type="content" source="../media/use-your-image-data/cross-origin-resource-sharing-requirement.png" alt-text="Screenshot that shows an error stating that CORS has not been turned on." lightbox="../media/use-your-image-data/cross-origin-resource-sharing-requirement.png":::
 
 ## Add your data by uploading files
 

articles/ai-services/openai/how-to/azure-developer-cli.md

@@ -1,6 +1,6 @@
 ---
 title: 'Use the Azure Developer CLI to deploy resources for Azure OpenAI On Your Data'
-titleSuffix: Azure OpenAI
+titleSuffix: Azure OpenAI Service
 description: Use this article to learn how to automate resource deployment for Azure OpenAI On Your Data.
 manager: nitinme
 ms.service: azure-ai-openai
@@ -13,75 +13,74 @@ recommendations: false
 
 # Use the Azure Developer CLI to deploy resources for Azure OpenAI On Your Data 
 
-Use this article to learn how to automate resource deployment for Azure OpenAI On Your Data. The Azure Developer CLI (`azd`) is an open-source, command-line tool that streamlines provisioning and deploying resources to Azure using a template system. The template contains infrastructure files to provision the necessary Azure OpenAI resources and configurations and includes the completed sample app code.
+Use this article to learn how to automate resource deployment for Azure OpenAI Service On Your Data. The Azure Developer CLI (`azd`) is an open-source command-line tool that streamlines provisioning and deploying resources to Azure by using a template system. The template contains infrastructure files to provision the necessary Azure OpenAI resources and configurations, and it includes the completed sample app code.
 
 ## Prerequisites
 
-- An Azure subscription - <a href="https://azure.microsoft.com/free/cognitive-services" target="_blank">Create one for free</a>.
+- An Azure subscription. [Create one for free](https://azure.microsoft.com/free/cognitive-services).
 - Access granted to Azure OpenAI in the desired Azure subscription.
 
-  Azure OpenAI requires registration and is currently only available to approved enterprise customers and partners. [See Limited access to Azure OpenAI Service](/legal/cognitive-services/openai/limited-access?context=/azure/ai-services/openai/context/context) for more information. You can apply for access to Azure OpenAI by completing the form at <a href="https://aka.ms/oai/access" target="_blank">https://aka.ms/oai/access</a>. Open an issue on this repo to contact us if you have an issue.
+  Azure OpenAI requires registration and is currently available only to approved enterprise customers and partners. For more information, see [Limited access to Azure OpenAI Service](/legal/cognitive-services/openai/limited-access?context=/azure/ai-services/openai/context/context). You can apply for access to Azure OpenAI by [completing the form](https://aka.ms/oai/access). Open an issue on this repo to contact us if you have a problem.
 
-- The Azure Developer CLI [installed](/azure/developer/azure-developer-cli/install-azd) on your machine
+- The Azure Developer CLI [installed](/azure/developer/azure-developer-cli/install-azd) on your machine.
 
 ## Clone and initialize the Azure Developer CLI template
 
-
-
-1. For the steps ahead, clone and initialize the template.
+1. For the steps ahead, clone and initialize the template:
 
     ```bash
     azd init --template openai-chat-your-own-data
     ```
-    
-2. The `azd init` command prompts you for the following information:
 
-    * Environment name: This value is used as a prefix for all Azure resources created by Azure Developer CLI. The name must be unique across all Azure subscriptions and must be between 3 and 24 characters long. The name can contain numbers and lowercase letters only.
+2. The `azd init` command prompts you to create an environment name. This value is used as a prefix for all Azure resources that Azure Developer CLI creates. The name:
+
+   - Must be unique across all Azure subscriptions.
+   - Must be 3 to 24 characters.
+   - Can contain numbers and lowercase letters only.
 
 ## Use the template to deploy resources
 
-1. Sign-in to Azure:
+1. Sign in to Azure:
 
     ```bash
     azd auth login
     ```
 
-1. Provision and deploy the OpenAI resource to Azure:
+1. Provision and deploy the Azure OpenAI resource to Azure:
 
     ```bash
     azd up
     ```
-    
-    `azd` prompts you for the following information:
-    
-    * Subscription: The Azure subscription that your resources are deployed to.
-    * Location: The Azure region where your resources are deployed.
-    
-    > [!NOTE]
-    > The sample `azd` template uses the `gpt-35-turbo-16k` model. A recommended region for this template is East US, since different Azure regions support different OpenAI models. You can visit the [Azure OpenAI Service Models](/azure/ai-services/openai/concepts/models) support page for more details about model support by region.
-    
+
+1. `azd` prompts you for the following information:
+
+    - `Subscription`: The Azure subscription that your resources are deployed to.
+    - `Location`: The Azure region where your resources are deployed.
+
     > [!NOTE]
-    > The provisioning process may take several minutes to complete. Wait for the task to finish before you proceed to the next steps.
-        
-1. Click the link `azd` outputs to navigate to the new resource group in the Azure portal. You should see the following top level resources:
-    
-    * An Azure OpenAI service with a deployed model
-    * An Azure Storage account you can use to upload your own data files
-    * An Azure AI Search service configured with the proper indexes and data sources
+    > The sample `azd` template uses the `gpt-35-turbo-16k` model. A recommended region for this template is East US, because different Azure regions support different OpenAI models. For more details about model support by region, go to the [Azure OpenAI Service Models](/azure/ai-services/openai/concepts/models) support page.
+
+    The provisioning process might take several minutes to complete. Wait for the task to finish before you proceed to the next steps.
+
+1. Select the link in the `azd` outputs to go to the new resource group in the Azure portal. The following top-level resources should appear:
+
+    - An Azure OpenAI service with a deployed model
+    - An Azure Storage account that you can use to upload your own data files
+    - An Azure AI Search service configured with the proper indexes and data sources
 
 ## Upload data to the storage account
 
-`azd` provisioned all of the required resources for you to chat with your own data, but you still need to upload the data files you want to make available to your AI service.
+The `azd` template provisioned all of the required resources for you to chat with your own data, but you still need to upload the data files that you want to make available to your AI service:
 
-1. Navigate to the new storage account in the Azure portal.
-1. On the left navigation, select **Storage browser**.
-1. Select **Blob containers** and then navigate into the **File uploads** container.
-1. Click the **Upload** button at the top of the screen. 
+1. Go to the new storage account in the Azure portal.
+1. On the left menu, select **Storage browser**.
+1. Select **Blob containers**, and then go to the **File uploads** container.
+1. Select the **Upload** button at the top of the pane.
 1. In the flyout menu that opens, upload your data.
- 
+
 > [!NOTE]
-> The search indexer is set to run every 5 minutes to index the data in the storage account. You can either wait a few minutes for the uploaded data to be indexed, or you can manually run the indexer from the search service page.
+> The search indexer is set to run every five minutes to index the data in the storage account. You can wait a few minutes for the uploaded data to be indexed, or you can manually run the indexer from the search service page.
 
 ## Connect or create an application
 
-After running the `azd` template and uploading your data, you're ready to start using Azure OpenAI on Your Data. See the [quickstart article](../use-your-data-quickstart.md) for code samples you can use to build your applications.
+After you run the `azd` template and upload your data, you're ready to start using Azure OpenAI On Your Data. See the [quickstart article](../use-your-data-quickstart.md) for code samples that you can use to build your applications.