Azure / Azure/azure-sdk-for-python
🐛 Face API v1.2 references missing Person Directory
- Dominant language
- Python
- Stars
- 5.6k
- Forks
- 3.4k
- Avg merge
- 1d 21h
- Merged PRs (30d)
- 193
Description
_Hello everyone,_
While exploring [Face API v1.2 docs](https://learn.microsoft.com/en-us/rest/api/face/operation-groups?view=rest-face-v1.2) (**not preview!**),
I noticed operations that are supposed to use [Person Directory](https://learn.microsoft.com/en-us/azure/ai-services/computer-vision/concept-face-recognition-data-structures#person-directory):
- [Identify From Person Directory](https://learn.microsoft.com/en-us/rest/api/face/face-recognition-operations/identify-from-person-directory?view=rest-face-v1.2)
- [Verify From Person Directory](https://learn.microsoft.com/en-us/rest/api/face/face-recognition-operations/verify-from-person-directory?view=rest-face-v1.2)
But [Face API v1.2 docs](https://learn.microsoft.com/en-us/rest/api/face/operation-groups?view=rest-face-v1.2) **don't tell you** what `Person Directory` is and how to deal with it.
Meanwhile, you can find that information in `v1.x-preview` docs:
- [v1.2-preview](https://learn.microsoft.com/en-us/rest/api/face/operation-groups?view=rest-face-v1.2-preview) - [Person Directory Operations](https://learn.microsoft.com/en-us/rest/api/face/person-directory-operations?view=rest-face-v1.2-preview)
- [v1.1-preview](https://learn.microsoft.com/en-us/rest/api/face/operation-groups?view=rest-face-v1.1-preview) - [Person Directory Operations](https://learn.microsoft.com/en-us/rest/api/face/person-directory-operations?view=rest-face-v1.1-preview)
- [v1.0-preview](https://learn.microsoft.com/en-us/rest/api/face/operation-groups?view=rest-face-v1.0-preview) - [Person Directory](https://learn.microsoft.com/en-us/rest/api/face/person-directory?view=rest-face-v1.0-preview)
🧐 It [looks like](https://learn.microsoft.com/en-us/azure/ai-services/computer-vision/how-to/use-persondirectory) `Person Directory` is a preview-only data structure,
so those operations shouldn't be listed for `v1.2`.
_Best regards!_
_P.S. I don't want to see an AI-generated response!_
Contributor guide
Assessment
This issue has not been assessed yet.