Face freshness

PatrickFarley · PatrickFarley · commit fbd4ea091403 · 2020-04-14T13:20:34.000-07:00
diff --git a/articles/cognitive-services/Face/Overview.md b/articles/cognitive-services/Face/Overview.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: overview
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 #Customer intent: As the developer of an app that deals with images of humans, I want to learn what the Face service does so I can determine if I should use its features.
 ---
@@ -17,9 +17,9 @@ ms.author: pafarley
 
 [!INCLUDE [TLS 1.2 enforcement](../../../includes/cognitive-services-tls-announcement.md)]
 
-The Azure Cognitive Services Face service provides algorithms that are used to detect, recognize, and analyze human faces in images. The ability to process human face information is important in many different software scenarios. Example scenarios are security, natural user interface, image content analysis and management, mobile apps, and robotics.
+The Azure Cognitive Services Face service provides algorithms that detect, recognize, and analyze human faces in images. The ability to process human face information is important in many different software scenarios. Example scenarios include security, natural user interface, image content analysis and management, mobile apps, and robotics.
 
-The Face service provides several different functions. Each function is outlined in the following sections. Read on to learn more about them.
+The Face service provides several different functions which are each outlined in the following sections.
 
 ## Face detection
 
@@ -66,7 +66,7 @@ After you create and train a database, you can do identification against the gro
 
 For more information about person identification, see the [Face recognition](concepts/face-recognition.md) concepts guide or the [Identify API](https://westus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239) reference documentation.
 
-## Use containers
+## Containers
 
 [Use the Face container](face-how-to-install-containers.md) to detect, recognize, and identify faces by installing a standardized Docker container closer to your data.
 
diff --git a/articles/cognitive-services/Face/QuickStarts/CSharp.md b/articles/cognitive-services/Face/QuickStarts/CSharp.md
@@ -9,14 +9,14 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: quickstart
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 #Customer intent: As a C# developer, I want to implement a simple Face detection scenario with REST calls, so that I can build more complex scenarios later on.
 ---
 
 # Quickstart: Detect faces in an image using the Face REST API and C#
 
-In this quickstart, you will use the Azure Face REST API with C# to detect human faces in an image.
+In this quickstart, you'll use the Azure Face REST API with C# to detect human faces in an image.
 
 If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
diff --git a/articles/cognitive-services/Face/QuickStarts/Java.md b/articles/cognitive-services/Face/QuickStarts/Java.md
@@ -9,14 +9,14 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: quickstart
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 #Customer intent: As a Java developer, I want to implement a simple Face detection scenario with REST calls, so that I can build more complex scenarios later on.
 ---
 
 # Quickstart: Detect faces in an image using the REST API and Java
 
-In this quickstart, you will use the Azure Face REST API with Java to detect human faces in an image.
+In this quickstart, you'll use the Azure Face REST API with Java to detect human faces in an image.
 
 If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin. 
 
diff --git a/articles/cognitive-services/Face/QuickStarts/JavaScript.md b/articles/cognitive-services/Face/QuickStarts/JavaScript.md
@@ -9,12 +9,12 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: quickstart
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 ---
 # Quickstart: Detect faces in an image using the REST API and JavaScript
 
-In this quickstart, you will use the Azure Face REST API with JavaScript to detect human faces in an image.
+In this quickstart, you'll use the Azure Face REST API with JavaScript to detect human faces in an image.
 
 ## Prerequisites
 
diff --git a/articles/cognitive-services/Face/QuickStarts/PHP.md b/articles/cognitive-services/Face/QuickStarts/PHP.md
@@ -9,12 +9,12 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: quickstart
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 ---
 # Quickstart: Detect faces in an image using the REST API and PHP
 
-In this quickstart, you will use the Azure Face REST API with PHP to detect human faces in an image.
+In this quickstart, you'll use the Azure Face REST API with PHP to detect human faces in an image.
 
 ## Prerequisites
 
diff --git a/articles/cognitive-services/Face/QuickStarts/Python.md b/articles/cognitive-services/Face/QuickStarts/Python.md
@@ -9,14 +9,14 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: quickstart
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 #Customer intent: As a Python developer, I want to implement a simple Face detection scenario with REST calls, so that I can build more complex scenarios later on.
 ---
 
 # Quickstart: Detect faces in an image using the Face REST API and Python
 
-In this quickstart, you will use the Azure Face REST API with Python to detect human faces in an image. The script will draw frames around the faces and superimpose gender and age information on the image.
+In this quickstart, you'll use the Azure Face REST API with Python to detect human faces in an image. The script will draw frames around the faces and superimpose gender and age information on the image.
 
 ![A man and a woman, each with a rectangle drawn around their faces and age and sex displayed on the image](../images/labelled-faces-python.png)
 
diff --git a/articles/cognitive-services/Face/QuickStarts/Ruby.md b/articles/cognitive-services/Face/QuickStarts/Ruby.md
@@ -9,12 +9,12 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: quickstart
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 ---
 # Quickstart: Detect faces in an image using the REST API and Ruby
 
-In this quickstart, you will use the Azure Face REST API with Ruby to detect human faces in an image.
+In this quickstart, you'll use the Azure Face REST API with Ruby to detect human faces in an image.
 
 ## Prerequisites
 
diff --git a/articles/cognitive-services/Face/QuickStarts/csharp-sdk.md b/articles/cognitive-services/Face/QuickStarts/csharp-sdk.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: quickstart
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 ---
 # Quickstart: Face client library for .NET
@@ -33,12 +33,9 @@ Use the Face client library for .NET to:
 
 ### Create a Face Azure resource
 
-Azure Cognitive Services are represented by Azure resources that you subscribe to. Create a resource for Face using the [Azure portal](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) or [Azure CLI](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli) on your local machine. You can also:
+Azure Cognitive Services are represented by Azure resources that you subscribe to. Create a resource for Face using the [Azure portal](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) or [Azure CLI](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli) on your local machine. You can also get a [trial key](https://azure.microsoft.com/try/cognitive-services/#decision) valid for seven days for free. After you sign up, it will be available on the [Azure website](https://azure.microsoft.com/try/cognitive-services/my-apis/).  
 
-* Get a [trial key](https://azure.microsoft.com/try/cognitive-services/#decision) valid for seven days for free. After you sign up, it will be available on the [Azure website](https://azure.microsoft.com/try/cognitive-services/my-apis/).  
-* View your resource on the [Azure portal](https://portal.azure.com/).
-
-After you get a key from your trial subscription or resource, [create an environment variable](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account#configure-an-environment-variable-for-authentication) for the key and endpoint URL, named `FACE_SUBSCRIPTION_KEY` and `FACE_ENDPOINT`, respectively.
+After you get a key from your trial subscription or resource, [create environment variables](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account#configure-an-environment-variable-for-authentication) for the key and endpoint URL, named `FACE_SUBSCRIPTION_KEY` and `FACE_ENDPOINT`, respectively.
 
 ### Create a new C# application
 
diff --git a/articles/cognitive-services/Face/QuickStarts/curl.md b/articles/cognitive-services/Face/QuickStarts/curl.md
@@ -9,13 +9,13 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: quickstart
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 #Customer intent: As a cURL developer, I want to implement a simple Face detection scenario with REST calls, so that I can build more complex scenarios later on.
 ---
 # Quickstart: Detect faces in an image using the Face REST API and cURL
 
-In this quickstart, you will use the Azure Face REST API with cURL to detect human faces in an image.
+In this quickstart, you'll use the Azure Face REST API with cURL to detect human faces in an image.
 
 If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin. 
 
diff --git a/articles/cognitive-services/Face/QuickStarts/go.md b/articles/cognitive-services/Face/QuickStarts/go.md
@@ -9,12 +9,12 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: quickstart
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 ---
 # Quickstart: Detect faces in an image using the REST API and Go
 
-In this quickstart, you will use the Azure Face REST API with Go to detect human faces in an image.
+In this quickstart, you'll use the Azure Face REST API with Go to detect human faces in an image.
 
 ## Prerequisites
 
diff --git a/articles/cognitive-services/Face/QuickStarts/node.md b/articles/cognitive-services/Face/QuickStarts/node.md
@@ -9,14 +9,14 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: quickstart
-ms.date: 12/06/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 #Customer intent: As a Node.js developer, I want to implement a simple Face detection scenario with REST calls, so that I can build more complex scenarios later on.
 ---
 
 # Quickstart: Detect faces in an image using the Face REST API and Node.js
 
-In this quickstart, you will use the Azure Face REST API with Node.js to detect human faces in an image.
+In this quickstart, you'll use the Azure Face REST API with Node.js to detect human faces in an image.
 
 If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin. 
 
diff --git a/articles/cognitive-services/Face/QuickStarts/python-sdk.md b/articles/cognitive-services/Face/QuickStarts/python-sdk.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: quickstart
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 ---
 
@@ -35,20 +35,17 @@ Use the Face client library for Python to:
 
 ### Create a Face Azure resource
 
-Azure Cognitive Services are represented by Azure resources that you subscribe to. Create a resource for Face using the [Azure portal](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) or [Azure CLI](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli) on your local machine. You can also:
+Azure Cognitive Services are represented by Azure resources that you subscribe to. Create a resource for Face using the [Azure portal](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) or [Azure CLI](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli) on your local machine. You can also get a [trial key](https://azure.microsoft.com/try/cognitive-services/#decision) valid for seven days for free. After you sign up, it will be available on the [Azure website](https://azure.microsoft.com/try/cognitive-services/my-apis/).  
 
-* Get a [trial key](https://azure.microsoft.com/try/cognitive-services/#decision) valid for seven days for free. After you sign up, it will be available on the [Azure website](https://azure.microsoft.com/try/cognitive-services/my-apis/).  
-* View your resource on the [Azure portal](https://portal.azure.com/)
-
-After you get a key from your trial subscription or resource, [create an environment variable](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account#configure-an-environment-variable-for-authentication) for the key, named `FACE_SUBSCRIPTION_KEY`.
+After you get a key from your trial subscription or resource, [create environment variables](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account#configure-an-environment-variable-for-authentication) for the key and endpoint, named `FACE_SUBSCRIPTION_KEY` and `FACE_ENDPOINT`, respectively.
  
 ### Create a new Python application
 
 Create a new Python script&mdash;*quickstart-file.py*, for example. Then open it in your preferred editor or IDE and import the following libraries.
 
 [!code-python[](~/cognitive-services-quickstart-code/python/Face/FaceQuickstart.py?name=snippet_imports)]
 
-Then, create variables for your resource's Azure endpoint and key. You may need to change the first part of the endpoint (`westus`) to match your subscription.
+Then, create variables for your resource's Azure endpoint and key.
 
 [!code-python[](~/cognitive-services-quickstart-code/python/Face/FaceQuickstart.py?name=snippet_subvars)]
 
diff --git a/articles/cognitive-services/Face/Tutorials/FaceAPIinCSharpTutorial.md b/articles/cognitive-services/Face/Tutorials/FaceAPIinCSharpTutorial.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: tutorial
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 #Customer intent: As a developer of image management software, I want to learn how to detect faces and display face data on the UI, so that I can follow a similar process for my specific features and needs.
 ---
diff --git a/articles/cognitive-services/Face/Tutorials/FaceAPIinJavaForAndroidTutorial.md b/articles/cognitive-services/Face/Tutorials/FaceAPIinJavaForAndroidTutorial.md
@@ -9,14 +9,14 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: face-api
 ms.topic: tutorial
-ms.date: 12/05/2019
+ms.date: 04/14/2020
 ms.author: pafarley
 #Customer intent: As a developer of an image management app, I want to learn how to detect faces and display face data on the UI, so that I can follow a similar process for my specific features and needs.
 ---
 
 # Tutorial: Create an Android app to detect and frame faces in an image
 
-In this tutorial, you will create an Android application that uses the Azure Face service, through the Java SDK, to detect human faces in an image. The application displays a selected image and draws a frame around each detected face.
+In this tutorial, you'll create an Android application that uses the Azure Face service, through the Java SDK, to detect human faces in an image. The application displays a selected image and draws a frame around each detected face.
 
 This tutorial shows you how to:
 
@@ -36,7 +36,7 @@ If you don't have an Azure subscription, create a [free account](https://azure.m
 
 - A Face subscription key. You can get a free trial subscription key from [Try Cognitive Services](https://azure.microsoft.com/try/cognitive-services/?api=face-api). Or, follow the instructions in [Create a Cognitive Services account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) to subscribe to the Face service and get your key. Then, [create environment variables](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account#configure-an-environment-variable-for-authentication) for the key and service endpoint string, named `FACE_SUBSCRIPTION_KEY` and `FACE_ENDPOINT`, respectively.
 - Any edition of [Visual Studio 2015 or 2017](https://www.visualstudio.com/downloads/).
-- [Android Studio](https://developer.android.com/studio/) with API level 22 or later (required by the Face client library).
+- [Android Studio](https://developer.android.com/studio/) with API level 22 or later.
 
 ## Create the Android Studio project
 
@@ -120,7 +120,7 @@ Run the application and browse for an image with a face. Wait a few seconds to a
 
 ## Next steps
 
-In this tutorial, you learned the basic process for using the Face Java SDK and created an application to detect and frame faces in an image. Next, learn more about the details of face detection.
+In this tutorial, you learned how to use the Face Java SDK to create an application to detect and frame faces in an image. Next, learn more about the details of face detection.
 
 > [!div class="nextstepaction"]
 > [How to Detect Faces in an Image](../Face-API-How-to-Topics/HowtoDetectFacesinImage.md)
