Merge pull request #188532 from PatrickFarley/face-updates

[cog svcs] Face updates

Author: jborsecnik

articles/cognitive-services/Face/includes/quickstarts/csharp-sdk.md

@@ -87,10 +87,10 @@ From the project directory, open the *program.cs* file and add the following `us
 
 In the application's **Program** class, create variables for your resource's key and endpoint.
 
-
 > [!IMPORTANT]
 > Go to the Azure portal. If the Face 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**. 
->
+
+> [!IMPORTANT]
 > Remember to remove the key from your code when you're done, and never post it publicly. For production, consider using a secure way of storing and accessing your credentials. See the Cognitive Services [security](../../../cognitive-services-security.md) article for more information.
 
 [!code-csharp[](~/cognitive-services-quickstart-code/dotnet/Face/FaceQuickstart.cs?name=snippet_creds)]
@@ -146,6 +146,12 @@ Create a new method to detect faces. The `DetectFaceExtract` method processes th
 
 [!code-csharp[](~/cognitive-services-quickstart-code/dotnet/Face/FaceQuickstart.cs?name=snippet_detect)]
 
+The above code processes the following remote images:
+
+![Photo of a woman smiling](../../media/quickstarts/detection-1.jpg)
+![Photo of a man, woman, and baby](../../media/quickstarts/detection-5.jpg)
+![Photo of an older man and woman](../../media/quickstarts/detection-6.jpg)
+
 > [!TIP]
 > You can also detect faces in a local image. See the [IFaceOperations](/dotnet/api/microsoft.azure.cognitiveservices.vision.face.ifaceoperations) methods such as **DetectWithStreamAsync**.
 
@@ -220,12 +226,19 @@ The following method detects faces in a set of target images and in a single sou
 
 [!code-csharp[](~/cognitive-services-quickstart-code/dotnet/Face/FaceQuickstart.cs?name=snippet_find_similar)]
 
+In this program, the following remote image will be used as the source:
+
+![Photo of a man smiling](../../media/quickstarts/find-similar.jpg)
+
 ### Print matches
 
 The following code prints the match details to the console:
 
 [!code-csharp[](~/cognitive-services-quickstart-code/dotnet/Face/FaceQuickstart.cs?name=snippet_find_similar_print)]
 
+In this program, the face detected in this image should be returned as the face that's similar to the source image face.
+
+![Photo of a man smiling; this is the same person as the previous image](../../media/quickstarts/family-1-dad-1.jpg)
 
 ## Run the application
 

articles/cognitive-services/Face/includes/quickstarts/javascript-sdk.md

@@ -73,7 +73,8 @@ Create variables for your resource's Azure endpoint and key.
 
 > [!IMPORTANT]
 > Go to the Azure portal. If the Face 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**. 
->
+
+> [!IMPORTANT]
 > Remember to remove the key from your code when you're done, and never post it publicly. For production, consider using a secure way of storing and accessing your credentials. See the Cognitive Services [security](../../../cognitive-services-security.md) article for more information.
 
 ```javascript
@@ -139,6 +140,12 @@ The "QualityForRecognition" attribute is an indicator of the overall image quali
 
 :::code language="js" source="~/cognitive-services-quickstart-code/javascript/Face/sdk_quickstart.js" id="detect":::
 
+The above code processes the following remote images:
+
+![Photo of a woman smiling](../../media/quickstarts/detection-1.jpg)
+![Photo of a man, woman, and baby](../../media/quickstarts/detection-5.jpg)
+![Photo of an older man and woman](../../media/quickstarts/detection-6.jpg)
+
 > [!TIP]
 > You can also detect faces in a local image. See the [Face](/javascript/api/@azure/cognitiveservices-face/face) methods such as [DetectWithStreamAsync](/javascript/api/@azure/cognitiveservices-face/face#detectWithStream_msRest_HttpRequestBody__FaceDetectWithStreamOptionalParams__ServiceCallback_DetectedFace____).
 
@@ -191,6 +198,14 @@ The following method detects faces in a set of target images and in a single sou
 
 :::code language="js" source="~/cognitive-services-quickstart-code/javascript/Face/sdk_quickstart.js" id="find_similar":::
 
+In this program, the following remote image will be used as the source:
+
+![Photo of a man smiling](../../media/quickstarts/find-similar.jpg)
+
+The face detected in this image should be returned as the face that's similar to the source image face.
+
+![Photo of a man smiling; this is the same person as the previous image](../../media/quickstarts/family-1-dad-1.jpg)
+
 ## Main
 
 Finally, create the `main` function and call it.

articles/cognitive-services/Face/includes/quickstarts/python-sdk.md

@@ -56,8 +56,9 @@ Then, create variables for your resource's Azure endpoint and key.
 
 > [!IMPORTANT]
 > Go to the Azure portal. If the Face 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**. 
->
-> Remember to remove the key from your code when you're done, and never post it publicly. For production, consider using a secure way of storing and accessing your credentials. For example, [Azure key vault](../../../../key-vault/general/overview.md).
+
+> [!IMPORTANT]
+> Remember to remove the key from your code when you're done, and never post it publicly. For production, consider using a secure way of storing and accessing your credentials. See the Cognitive Services [security](../../../cognitive-services-security.md) article for more information.
 
 ## Object model
 

articles/cognitive-services/Face/includes/quickstarts/rest-api.md

@@ -43,7 +43,9 @@ Make the following changes:
    [!INCLUDE [subdomains-note](../../../../../includes/cognitive-services-custom-subdomains-note.md)]
 1. Optionally change the URL in the body of the request to point to a different image.
 
-Once you've made your changes, open a command prompt and enter the new command. 
+Once you've made your changes, open a command prompt and enter the new command. The code will process the following remote image.
+
+![An older man and woman](../../media/quickstarts/lillian-gish.jpg)
 
 ### Examine the results
 
@@ -90,13 +92,6 @@ The returned face information now includes face attributes. For example:
         "roll": 0.1,
         "yaw": -32.9
       },
-      "gender": "female",
-      "age": 22.9,
-      "facialHair": {
-        "moustache": 0,
-        "beard": 0,
-        "sideburns": 0
-      },
       "glasses": "NoGlasses",
       "emotion": {
         "anger": 0,
@@ -183,6 +178,8 @@ Finally, detect the single source face that you'll use for matching, and save it
 
 :::code source="~/cognitive-services-quickstart-code/curl/face/detect.sh" ID="similar_matcher":::
 
+![Photo of a man smiling](../../media/quickstarts/find-similar.jpg)
+
 ### Find matches
 
 Copy the following command to a text editor.
@@ -202,7 +199,7 @@ Use the following JSON content for the `body` value:
 
 ### Examine the results
 
-You'll receive a JSON response that lists the IDs of the faces that match your query face.
+You'll receive a JSON response that lists the IDs of the faces that match your query face. 
 
 ```json
 [
@@ -214,6 +211,10 @@ You'll receive a JSON response that lists the IDs of the faces that match your q
 ] 
 ```
 
+In this program, the face detected in this image should be returned as the face that's similar to the source image face.
+
+![Photo of a man smiling; this is the same person as the previous image](../../media/quickstarts/family-1-dad-1.jpg)
+
 ## Clean up resources
 
 If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.