azure-sdk-for-python icon indicating copy to clipboard operation
azure-sdk-for-python copied to clipboard

Missed QueryCaptionType and QueryAnswerType valid params

Open MosheHM opened this issue 2 months ago • 6 comments

Type of issue

Missing information

Description

On the documentation pages for both azure.search.documents.models.QueryCaptionType and azure.search.documents.models.QueryAnswerType, the "Fields" sections are shown as empty tables or without listing the valid enum members/parameter values.

For example, the expected valid values such as EXTRACTIVE and NONE are mentioned in the usage text but are not shown in the "Fields" lists/tables. This makes it unclear for users which values are acceptable or supported when using these enums.

Page URL

https://learn.microsoft.com/en-us/python/api/azure-search-documents/azure.search.documents.models.querycaptiontype?view=azure-python

Content source URL

https://github.com/MicrosoftDocs/azure-docs-sdk-python/blob/main/docs-ref-autogen/azure-search-documents/azure.search.documents.models.QueryCaptionType.yml

Document Version Independent Id

e4fb3b83-7a32-28ca-192e-30e3c2047a53

Platform Id

6ca78138-8812-154d-e8fc-fee15fbe1287

Article author

@lmazuel

Metadata

  • ID: e562dcf0-80a3-b437-6acf-77b7bff19e29
  • PlatformId: 6ca78138-8812-154d-e8fc-fee15fbe1287

MosheHM avatar Nov 18 '25 12:11 MosheHM

Thanks for reaching out.

I cannot see the values in the Fields table

Image

did I miss anything?

xiangyan99 avatar Nov 21 '25 23:11 xiangyan99

Hi @MosheHM. Thank you for opening this issue and giving us the opportunity to assist. To help our team better understand your issue and the details of your scenario please provide a response to the question asked above or the information requested above. This will help us more accurately address your issue.

github-actions[bot] avatar Nov 21 '25 23:11 github-actions[bot]

hi @xiangyan99 yes, as you can see there is a options to pipe in both documentations such as count-3, highlight ..., and i expecting to see all the options of the piping in a special list or order as i sew in other MS docs.

MosheHM avatar Nov 23 '25 08:11 MosheHM

Thanks for the information.

Regarding "as i sew in other MS docs".

Could you give some samples?

xiangyan99 avatar Dec 01 '25 22:12 xiangyan99

Hi @MosheHM. Thank you for opening this issue and giving us the opportunity to assist. To help our team better understand your issue and the details of your scenario please provide a response to the question asked above or the information requested above. This will help us more accurately address your issue.

github-actions[bot] avatar Dec 01 '25 22:12 github-actions[bot]

Hi @MosheHM, we're sending this friendly reminder because we haven't heard back from you in 7 days. We need more information about this issue to help address it. Please be sure to give us your input. If we don't hear back from you within 14 days of this comment the issue will be automatically closed. Thank you!

github-actions[bot] avatar Dec 09 '25 03:12 github-actions[bot]