Merge pull request #247395 from TimShererWithAquent/us141588a

Azure OpenAI Freshness Pass - User Story: 141588

Author: v-dirichards

articles/ai-services/computer-vision/includes/curl-quickstart.md

@@ -8,73 +8,75 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: computer-vision
 ms.topic: include
-ms.date: 04/19/2021
+ms.date: 08/07/2023
 ms.author: pafarley
 ms.custom: seodec18
 ---
 
-Use the Optical character recognition REST API to read printed and handwritten text.
+Use the optical character recognition (OCR) REST API to read printed and handwritten text.
 
 > [!NOTE]
 > This quickstart uses cURL commands to call the REST API. You can also call the REST API using a programming language. See the GitHub samples for examples in [C#](https://github.com/Azure-Samples/cognitive-services-quickstart-code/tree/master/dotnet/ComputerVision/REST), [Python](https://github.com/Azure-Samples/cognitive-services-quickstart-code/tree/master/python/ComputerVision/REST), [Java](https://github.com/Azure-Samples/cognitive-services-quickstart-code/tree/master/java/ComputerVision/REST), and [JavaScript](https://github.com/Azure-Samples/cognitive-services-quickstart-code/tree/master/javascript/ComputerVision/REST).
 
 ## Prerequisites
 
-* An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/) 
-* Once you have your Azure subscription, <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision"  title="create a Vision resource"  target="_blank">create a Vision resource</a> in the Azure portal to get your key and endpoint. After it deploys, select **Go to resource**.
-  * You will need the key and endpoint from the resource you create to connect your application to the Azure AI Vision service. You'll paste your key and endpoint into the code below later in the quickstart.
-  * You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
-* [cURL](https://curl.haxx.se/) installed
-
+- An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/).
+- [cURL](https://curl.haxx.se/) installed.
+- <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision" title="create a Vision resource" target="_blank">An Azure AI Vision resource</a>. You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
+- The key and endpoint from the resource you create to connect your application to the Azure AI Vision service.
 
+  1. After your Azure Vision resource deploys, select **Go to resource**.
+  1. In the left navigation menu, select **Keys and Endpoint**.
+  1. Copy one of the keys and the **Endpoint** for use later in the quickstart.
 
 ## Read printed and handwritten text
 
-The OCR service can extract visible text in an image or document and convert it to a character stream. For more information on text extraction, see the [Optical character recognition (OCR) overview](../overview-ocr.md).
-
+The optical character recognition (OCR) service can extract visible text in an image or document and convert it to a character stream. For more information on text extraction, see the [OCR overview](../overview-ocr.md).
 
 ### Call the Read API
 
 To create and run the sample, do the following steps:
 
 1. Copy the following command into a text editor.
 1. Make the following changes in the command where needed:
-    1. Replace the value of `<subscriptionKey>` with your key.
-    1. Replace the first part of the request URL (`westcentralus`) with the text in your own endpoint URL.
+
+   1. Replace the value of `<key>` with your key.
+   1. Replace the first part of the request URL (`https://westcentralus.api.cognitive.microsoft.com/`) with the text in your own endpoint URL.
         [!INCLUDE [Custom subdomains notice](../../../../includes/cognitive-services-custom-subdomains-note.md)]
-    1. Optionally, change the image URL in the request body (`https://upload.wikimedia.org/wikipedia/commons/thumb/a/af/Atomist_quote_from_Democritus.png/338px-Atomist_quote_from_Democritus.png\`) to the URL of a different image to be analyzed.
-1. Open a command prompt window.
-1. Paste the command from the text editor into the command prompt window, and then run the command.
+   1. Optionally, change the image URL in the request body (`https://upload.wikimedia.org/wikipedia/commons/thumb/a/af/Atomist_quote_from_Democritus.png/338px-Atomist_quote_from_Democritus.png\`) to the URL of a different image to be analyzed.
 
-```bash
-curl -v -X POST "https://westcentralus.api.cognitive.microsoft.com/vision/v3.2/read/analyze" -H "Content-Type: application/json" -H "Ocp-Apim-Subscription-Key: <subscription key>" --data-ascii "{\"url\":\"https://upload.wikimedia.org/wikipedia/commons/thumb/a/af/Atomist_quote_from_Democritus.png/338px-Atomist_quote_from_Democritus.png\"}"
-```
+1. Open a console window.
+1. Paste the command from the text editor into the console window, and then run the command.
+
+   ```bash
+   curl -v -X POST "https://westcentralus.api.cognitive.microsoft.com/vision/v3.2/read/analyze" -H "Content-Type: application/json" -H "Ocp-Apim-Subscription-Key: <key>" --data-ascii "{\"url\":\"https://upload.wikimedia.org/wikipedia/commons/thumb/a/af/Atomist_quote_from_Democritus.png/338px-Atomist_quote_from_Democritus.png\"}"
+   ```
 
-The response will include an `Operation-Location` header, whose value is a unique URL. You use this URL to query the results of the Read operation. The URL expires in 48 hours.
+The response includes an `Operation-Location` header, whose value is a unique URL. You use this URL to query the results of the Read operation. The URL expires in 48 hours.
 
 ### Optionally, specify the model version
-As an optional step, see [How to specify the model version](../how-to/call-read-api.md#determine-how-to-process-the-data-optional). For example, to explicitly specify the latest GA model, use `model-version=2022-04-30` as the parameter. Skipping the parameter or using `model-version=latest` automatically uses the most recent GA model.
+
+As an optional step, see [Determine how to process the data](../how-to/call-read-api.md#determine-how-to-process-the-data-optional). For example, to explicitly specify the latest GA model, use `model-version=2022-04-30` as the parameter. Skipping the parameter or using `model-version=latest` automatically uses the most recent GA model.
+
 ```bash
 curl -v -X POST "https://westcentralus.api.cognitive.microsoft.com/vision/v3.2/read/analyze?model-version=2022-04-30" -H "Content-Type: application/json" -H "Ocp-Apim-Subscription-Key: <subscription key>" --data-ascii "{\"url\":\"https://upload.wikimedia.org/wikipedia/commons/thumb/a/af/Atomist_quote_from_Democritus.png/338px-Atomist_quote_from_Democritus.png\"}"
 ```
 
 ### Get Read results
 
 1. Copy the following command into your text editor.
-1. Replace the URL with the `Operation-Location` value you copied in the previous step.
-1. Make the following changes in the command where needed:
-    1. Replace the value of `<subscriptionKey>` with your subscription key.
-1. Open a command prompt window.
-1. Paste the command from the text editor into the command prompt window, and then run the command.
-
-```bash
-curl -v -X GET "https://westcentralus.api.cognitive.microsoft.com/vision/v3.2/read/analyzeResults/{operationId}" -H "Ocp-Apim-Subscription-Key: {subscription key}" --data-ascii "{body}" 
-```
+1. Replace the URL with the `Operation-Location` value you copied in the previous procedure.
+1. Replace the value of `<key>` with your key.
+1. Open a console window.
+1. Paste the command from the text editor into the console window, and then run the command.
 
+   ```bash
+   curl -v -X GET "https://westcentralus.api.cognitive.microsoft.com/vision/v3.2/read/analyzeResults/{operationId}" -H "Ocp-Apim-Subscription-Key: {key}" --data-ascii "{body}" 
+   ```
 
 ### Examine the response
 
-A successful response is returned in JSON. The sample application parses and displays a successful response in the command prompt window, similar to the following example:
+A successful response is returned in JSON. The sample application parses and displays a successful response in the console window, similar to the following example:
 
 ```json
 {
@@ -134,7 +136,12 @@ A successful response is returned in JSON. The sample application parses and dis
 
 ```
 
+## Clean up resources
+
+If you want to clean up and remove an Azure AI services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.
 
+- [Clean up resources with the Azure portal](../../multi-service-resource.md?pivots=azportal#clean-up-resources)
+- [Clean up resources with Azure CLI](../../multi-service-resource.md?pivots=azcli#clean-up-resources)
 
 ## Next steps
 

articles/ai-services/computer-vision/includes/environment-variables.md

@@ -3,20 +3,20 @@ author: PatrickFarley
 ms.service: cognitive-services
 ms.subservice: computer-vision
 ms.topic: include
-ms.date: 02/22/2023
+ms.date: 08/07/2023
 ms.author: pafarley
 ---
 
 ## Create environment variables 
 
-In this example, you'll write your credentials to environment variables on the local machine running the application.
+In this example, write your credentials to environment variables on the local machine that runs the application.
 
 [!INCLUDE [find key and endpoint](./find-key.md)]
 
 > [!TIP]
 > Don't include the key directly in your code, and never post it publicly. See the Azure AI services [security](../../security-features.md) article for more authentication options like [Azure Key Vault](../../use-key-vault.md).
 
-To set the environment variable for your key and endpoint, open a console window and follow the instructions for your operating system and development environment. 
+To set the environment variable for your key and endpoint, open a console window and follow the instructions for your operating system and development environment.
 
 1. To set the `VISION_KEY` environment variable, replace `your-key` with one of the keys for your resource.
 2. To set the `VISION_ENDPOINT` environment variable, replace `your-endpoint` with the endpoint for your resource.

articles/ai-services/computer-vision/includes/find-key.md

@@ -8,8 +8,8 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: computer-vision
 ms.topic: include
-ms.date: 03/23/2022
+ms.date: 08/07/2023
 ms.author: pafarley
 ---
 
-Go to the Azure portal. If the resource you created in the **Prerequisites** section deployed successfully, click the **Go to Resource** button under **Next Steps**. You can find your key and endpoint in the resource's **key and endpoint** page, under **resource management**. Your resource key is not the same as your Azure subscription ID.
+Go to the Azure portal. If the resource you created in the **Prerequisites** section deployed successfully, select **Go to resource** under **Next Steps**. You can find your key and endpoint under **Resource Management** in the **Keys and Endpoint** page. Your resource key isn't the same as your Azure subscription ID.

articles/ai-services/computer-vision/includes/ocr-studio-quickstart.md

@@ -9,25 +9,31 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: computer-vision
 ms.topic: include
-ms.date: 06/13/2022
+ms.date: 08/07/2023
 ms.author: pafarley
 ---
 
 ## Prerequisites
 
-* Sign in to [Vision Studio](https://portal.vision.cognitive.azure.com/) with your Azure subscription and Azure AI services resource. See the [Get started section](../overview-vision-studio.md#get-started-using-vision-studio) of the overview if you need help with this step.
+- An Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services/).
+- [An Azure AI Vision resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision). You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
+- Connect to [Vision Studio](https://portal.vision.cognitive.azure.com/).
 
+  - You might need to sign in.
+  - After you sign in, select **View all resources**. If necessary, select **Refresh**. Verify that your resource is available.
 
+  For more information, see [Get started using Vision Studio](../overview-vision-studio.md#get-started-using-vision-studio).
 
 ## Read printed and handwritten text
 
-1. Select the **Extract text** tab, and select panel titled **Extract text from images**.
-1. To use the try-it-out experience, you'll need to choose a resource and acknowledge it will incur usage according to your [pricing tier](https://azure.microsoft.com/pricing/details/cognitive-services/computer-vision/).
+1. Under **Optical character recognition**, select **Extract text from images**.
+1. Under **Try it out**, acknowledge that this demo incurs usage to your Azure account. For more information, see [Azure AI Vision pricing](https://azure.microsoft.com/pricing/details/cognitive-services/computer-vision/).
 1. Select an image from the available set, or upload your own.
-1. After you select your image, you'll see the extracted text appear in the output window. You can also select the **JSON** tab to see the JSON output that the API call returns.
-1. Below the try-it-out experience are next steps to start using this capability in your own application.
+1. If necessary, select **Please select a resource** to select your resource.
 
+   After you select your image, the extracted text appears in the output window. You can also select the **JSON** tab to see the JSON output that the API call returns.
 
+Below the try-it-out experience are next steps to start using this capability in your own application.
 
 ## Next steps
 
@@ -36,4 +42,4 @@ In this quickstart, you used Vision Studio to access the Read API. Next, learn m
 > [!div class="nextstepaction"]
 > [Call the Read API](../how-to/call-read-api.md)
 
-* [OCR overview](../overview-ocr.md)
+- [OCR overview](../overview-ocr.md)