edit new ov doc

docs-ref-services/latest/cognitiveservices-vision-face-readme.md

@@ -1,37 +1,45 @@
 ---
-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
 
+> [!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. 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 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.
 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:
 
+```console
+pip install --upgrade azure-cognitiveservices-vision-face
+```
 
+For code examples, see [Cognitive Services Face](/python/api/overview/azure/cognitive-services) on docs.microsoft.com.
 
-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](/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)
-