From 43f12b66866ec8e99003300ce683998aa7b58562 Mon Sep 17 00:00:00 2001 From: Patrick Farley Date: Wed, 14 Sep 2022 16:29:48 -0400 Subject: [PATCH 1/4] edit new ov doc --- .../cognitiveservices/face-readme.md | 33 ------------------- .../cognitiveservices/face-readme.md.orig | 33 ------------------- .../cognitiveservices-vision-face-readme.md | 16 +++++++-- 3 files changed, 13 insertions(+), 69 deletions(-) delete mode 100644 docs-ref-services/cognitiveservices/face-readme.md delete mode 100644 docs-ref-services/cognitiveservices/face-readme.md.orig diff --git a/docs-ref-services/cognitiveservices/face-readme.md b/docs-ref-services/cognitiveservices/face-readme.md deleted file mode 100644 index 03020cc3a5a9..000000000000 --- a/docs-ref-services/cognitiveservices/face-readme.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Face API -author: PatrickFarley -ms.author: pafarley -ms.date: 06/21/2021 -ms.topic: article -ms.prod: azure -ms.technology: azure -ms.devlang: python -ms.service: face-api ---- - -# Azure Face API - -> [!IMPORTANT] -> Face service access is limited based on eligibility and usage criteria in order to support our Responsible AI principles. Face service is only available to Microsoft managed customers and partners. Use the [Face Recognition intake form](https://aka.ms/facerecognition) to apply for access. - -> [!IMPORTANT] -> Microsoft will be retiring facial recognition capabilities that can be used to try to infer emotional states and identity attributes which, if misused, can subject people to stereotyping, discrimination or unfair denial of services. These include capabilities that predict emotion, gender, age, smile, facial hair, hair and makeup. Existing customers have until June 30, 2023 to discontinue use of these capabilities before they are retired. Read more about this decision [here](https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/). - -The Azure Face service provides AI algorithms that detect, recognize, and analyze human faces in images. - -## Install the library - -After installing Python, you can install the client library with: - -```console -pip install --upgrade azure-cognitiveservices-vision-face -``` - -## Next Steps - -Go to the Face service [Overview](https://docs.microsoft.com/azure/cognitive-services/face/overview) or follow a [quickstart](https://docs.microsoft.com/azure/cognitive-services/face/quickstarts/client-libraries) to get started. diff --git a/docs-ref-services/cognitiveservices/face-readme.md.orig b/docs-ref-services/cognitiveservices/face-readme.md.orig deleted file mode 100644 index 70e0ab745920..000000000000 --- a/docs-ref-services/cognitiveservices/face-readme.md.orig +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Face API -author: PatrickFarley -ms.author: pafarley -ms.date: 06/21/2021 -ms.topic: article -ms.prod: azure -ms.technology: azure -ms.devlang: python -ms.service: face-api ---- - -# Azure Face API - -> [!IMPORTANT] -> Face service access is limited based on eligibility and usage criteria in order to support our Responsible AI principles. Face service is only available to Microsoft managed customers and partners. Use the [Face Recognition intake form](https://aka.ms/facerecognition) to apply for access. - -> [!IMPORTANT] -> The following Face attributes have been categorized as **sensitive attributes**: `age`, `gender`, `emotion`, `smile`, `hair`, `facial hair`, `makeup`. New Face customers won't be able to use these attributes unless they get approved for a corresponding scenario through the [Face Recognition Limited Access Review](https://aka.ms/facerecognition) form. Existing customers will have access to **sensitive attributes** until June 21 2023, after which they must also request access. - -The Azure Face service provides AI algorithms that detect, recognize, and analyze human faces in images. - -## Install the library - -After installing Python, you can install the client library with: - -```console -pip install --upgrade azure-cognitiveservices-vision-face -``` - -## Next Steps - -Go to the Face service [Overview](https://docs.microsoft.com/azure/cognitive-services/face/overview) or follow a [quickstart](https://docs.microsoft.com/azure/cognitive-services/face/quickstarts/client-libraries) to get started. diff --git a/docs-ref-services/latest/cognitiveservices-vision-face-readme.md b/docs-ref-services/latest/cognitiveservices-vision-face-readme.md index 3b36b913b9eb..d3b9cdf2eb9e 100644 --- a/docs-ref-services/latest/cognitiveservices-vision-face-readme.md +++ b/docs-ref-services/latest/cognitiveservices-vision-face-readme.md @@ -13,18 +13,29 @@ ms.service: face # Microsoft Azure SDK for Python +> [!IMPORTANT] +> Face service access is limited based on eligibility and usage criteria in order to support our Responsible AI principles. Face service is only available to Microsoft managed customers and partners. Use the [Face Recognition intake form](https://aka.ms/facerecognition) to apply for access. + +> [!IMPORTANT] +> Microsoft will be retiring facial recognition capabilities that can be used to try to infer emotional states and identity attributes which, if misused, can subject people to stereotyping, discrimination or unfair denial of services. These include capabilities that predict emotion, gender, age, smile, facial hair, hair and makeup. Existing customers have until June 30, 2023 to discontinue use of these capabilities before they are retired. Read more about this decision [here](https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/). + This is the Microsoft Azure Cognitive Services Face Client Library. This package has been tested with Python 2.7, 3.5, 3.6, 3.7 and 3.8. For a more complete view of Azure libraries, see the [azure sdk python release](https://aka.ms/azsdk/python/all). - # Usage +After installing Python, you can install the client library with: - +```console +pip install --upgrade azure-cognitiveservices-vision-face +``` For code examples, see [Cognitive Services Face](https://docs.microsoft.com/python/api/overview/azure/cognitive-services) on docs.microsoft.com. +## Next Steps + +Go to the Face service [Overview](https://docs.microsoft.com/azure/cognitive-services/face/overview) or follow a [quickstart](https://docs.microsoft.com/azure/cognitive-services/face/quickstarts/client-libraries) to get started. # Provide Feedback @@ -32,6 +43,5 @@ If you encounter any bugs or have suggestions, please file an issue in the [Issues](https://github.com/Azure/azure-sdk-for-python/issues) section of the project. - ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-python%2Fazure-cognitiveservices-vision-face%2FREADME.png) From 3631d5d5fc616a212221e04d6174f220e85d09a6 Mon Sep 17 00:00:00 2001 From: Patrick Farley Date: Wed, 14 Sep 2022 16:47:41 -0400 Subject: [PATCH 2/4] writer edits --- .../cognitiveservices-vision-face-readme.md | 21 +++++++++---------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/docs-ref-services/latest/cognitiveservices-vision-face-readme.md b/docs-ref-services/latest/cognitiveservices-vision-face-readme.md index d3b9cdf2eb9e..2044596bca0b 100644 --- a/docs-ref-services/latest/cognitiveservices-vision-face-readme.md +++ b/docs-ref-services/latest/cognitiveservices-vision-face-readme.md @@ -1,14 +1,14 @@ --- -title: +title: Face SDK for Python +description: This is the Microsoft Azure Cognitive Services Face Client Library. keywords: Azure, python, SDK, API, azure-cognitiveservices-vision-face, face -author: ramya-rao-a -ms.author: ramyar -ms.date: 03/16/2021 +author: PatrickFarley +ms.author: pafarley +ms.date: 09/14/2022 ms.topic: reference -ms.prod: azure ms.technology: azure ms.devlang: python -ms.service: face +ms.service: cognitive-services --- # Microsoft Azure SDK for Python @@ -23,7 +23,7 @@ This is the Microsoft Azure Cognitive Services Face Client Library. This package has been tested with Python 2.7, 3.5, 3.6, 3.7 and 3.8. For a more complete view of Azure libraries, see the [azure sdk python release](https://aka.ms/azsdk/python/all). -# Usage +## Usage After installing Python, you can install the client library with: @@ -31,17 +31,16 @@ After installing Python, you can install the client library with: pip install --upgrade azure-cognitiveservices-vision-face ``` -For code examples, see [Cognitive Services Face](https://docs.microsoft.com/python/api/overview/azure/cognitive-services) on docs.microsoft.com. +For code examples, see [Cognitive Services Face](/python/api/overview/azure/cognitive-services) on docs.microsoft.com. ## Next Steps -Go to the Face service [Overview](https://docs.microsoft.com/azure/cognitive-services/face/overview) or follow a [quickstart](https://docs.microsoft.com/azure/cognitive-services/face/quickstarts/client-libraries) to get started. +Go to the Face service [Overview](/azure/cognitive-services/face/overview) or follow a [quickstart](/azure/cognitive-services/face/quickstarts/client-libraries) to get started. -# Provide Feedback +## Provide Feedback If you encounter any bugs or have suggestions, please file an issue in the [Issues](https://github.com/Azure/azure-sdk-for-python/issues) section of the project. ![Impressions](https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-python%2Fazure-cognitiveservices-vision-face%2FREADME.png) - From 63f4d9a2cb6715055c0642276fdd1094b92c3aae Mon Sep 17 00:00:00 2001 From: Patrick Farley Date: Wed, 14 Sep 2022 17:35:23 -0400 Subject: [PATCH 3/4] fix meta --- docs-ref-services/latest/cognitiveservices-vision-face-readme.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs-ref-services/latest/cognitiveservices-vision-face-readme.md b/docs-ref-services/latest/cognitiveservices-vision-face-readme.md index 2044596bca0b..30414e79d9f2 100644 --- a/docs-ref-services/latest/cognitiveservices-vision-face-readme.md +++ b/docs-ref-services/latest/cognitiveservices-vision-face-readme.md @@ -6,7 +6,6 @@ author: PatrickFarley ms.author: pafarley ms.date: 09/14/2022 ms.topic: reference -ms.technology: azure ms.devlang: python ms.service: cognitive-services --- From 34df8744f417517f21c07928528da8001f7ea685 Mon Sep 17 00:00:00 2001 From: Patrick Farley Date: Wed, 14 Sep 2022 17:46:54 -0400 Subject: [PATCH 4/4] update note --- .../latest/cognitiveservices-vision-face-readme.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs-ref-services/latest/cognitiveservices-vision-face-readme.md b/docs-ref-services/latest/cognitiveservices-vision-face-readme.md index 30414e79d9f2..a9fc55569e27 100644 --- a/docs-ref-services/latest/cognitiveservices-vision-face-readme.md +++ b/docs-ref-services/latest/cognitiveservices-vision-face-readme.md @@ -13,10 +13,10 @@ ms.service: cognitive-services # Microsoft Azure SDK for Python > [!IMPORTANT] -> Face service access is limited based on eligibility and usage criteria in order to support our Responsible AI principles. Face service is only available to Microsoft managed customers and partners. Use the [Face Recognition intake form](https://aka.ms/facerecognition) to apply for access. +> Face service access is limited based on eligibility and usage criteria in order to support our Responsible AI principles. Face service is only available to Microsoft managed customers and partners. Use the [Face Recognition intake form](https://aka.ms/facerecognition) to apply for access. For more information, see the [Face limited access](/legal/cognitive-services/computer-vision/limited-access-identity?context=%2Fazure%2Fcognitive-services%2Fcomputer-vision%2Fcontext%2Fcontext) page. > [!IMPORTANT] -> Microsoft will be retiring facial recognition capabilities that can be used to try to infer emotional states and identity attributes which, if misused, can subject people to stereotyping, discrimination or unfair denial of services. These include capabilities that predict emotion, gender, age, smile, facial hair, hair and makeup. Existing customers have until June 30, 2023 to discontinue use of these capabilities before they are retired. Read more about this decision [here](https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/). +> Microsoft will be retiring facial recognition capabilities that can be used to try to infer emotional states and identity attributes which, if misused, can subject people to stereotyping, discrimination or unfair denial of services. These include capabilities that predict emotion, gender, age, smile, facial hair, hair and makeup. Existing customers have until June 30, 2023 to discontinue use of these capabilities before they are retired. Read more about this decision in the [announcement post](https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/). This is the Microsoft Azure Cognitive Services Face Client Library. This package has been tested with Python 2.7, 3.5, 3.6, 3.7 and 3.8.