-
Notifications
You must be signed in to change notification settings - Fork 5.3k
Add the missing description to summarization parameter #20809
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from 38 commits
f574803
4728032
192c15a
cd02418
40e6bbe
0c6ad62
6b8a0ee
a438b31
d092460
3732811
ee2291e
37af083
adfe0c7
166aef5
d0ed411
dddd312
babfe18
7c8e244
c178261
316dc4d
6d0a8cb
09a1d8d
c75a26d
51239f5
ea3fded
667ec78
fe4eb43
5843bf6
069a374
be53877
69ef8da
a486385
aecabc0
055183a
1da2ccb
545d4ae
cfd67f7
44df77f
4d69d00
dd79fb5
a6ad551
48e305d
875df36
c9f050c
f5c0456
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -16,10 +16,7 @@ | |
"description": "The error object.", | ||
"$ref": "#/definitions/Error" | ||
} | ||
}, | ||
"required": [ | ||
"error" | ||
] | ||
} | ||
}, | ||
"Error": { | ||
"type": "object", | ||
|
@@ -805,7 +802,8 @@ | |
"properties": { | ||
"sentenceCount": { | ||
"type": "integer", | ||
"format": "int32" | ||
"format": "int32", | ||
"description": "It controls the approximate number of sentences in the output summaries." | ||
}, | ||
"stringIndexType": { | ||
"$ref": "#/definitions/StringIndexType" | ||
|
@@ -1540,12 +1538,11 @@ | |
}, | ||
"parameters": { | ||
"Endpoint": { | ||
"name": "Endpoint", | ||
"name": "endpoint", | ||
"description": "Supported Cognitive Services endpoint (e.g., https://<resource-name>.api.cognitiveservices.azure.com).", | ||
"x-ms-parameter-location": "client", | ||
"required": true, | ||
"type": "string", | ||
"format": "uri", | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. This is to make consistent with July preview. Is that OK? @heaths There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. For anything new, I recommend declaring the There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @heaths there are so many conflict rules and I'm confused which rule trump which rule... This is existing stuff, not new. In /specification folder, the latest stable version and the latest preview has no format, only /dev folder has format uri. Given we cannot break anything GA, we should fix /dev folder as what I'm doing here - remove format uri, right? |
||
"in": "path", | ||
"x-ms-skip-url-encoding": true | ||
}, | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -3,7 +3,7 @@ | |
"info": { | ||
"title": "Microsoft Cognitive Language Service - Question Answering - Authoring", | ||
"description": "The language service API is a suite of natural language processing (NLP) skills built with best-in-class Microsoft machine learning algorithms. The API can be used to analyze unstructured text for tasks such as sentiment analysis, key phrase extraction, language detection and question answering. Further documentation can be found in <a href=\"https://docs.microsoft.com/en-us/azure/cognitive-services/text-analytics/overview\">https://docs.microsoft.com/en-us/azure/cognitive-services/text-analytics/overview</a>.", | ||
"version": "2022-07-01-preview" | ||
"version": "2022-10-01-preview" | ||
}, | ||
"securityDefinitions": { | ||
"AADToken": { | ||
|
@@ -32,7 +32,7 @@ | |
} | ||
], | ||
"x-ms-parameterized-host": { | ||
"hostTemplate": "{Endpoint}/language/authoring", | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Can we know the reason for this change ? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. It causes validation error. Let me revert this, and request exception. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Standalone fix for this: #20927 |
||
"hostTemplate": "{Endpoint}/language", | ||
"useSchemePrefix": false, | ||
"parameters": [ | ||
{ | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In /specification folder, the latest stable is uppercase "Endpoint", and latest preview is lowercase "endpoint", so no matter what we do here, it is a breaking change. So I will revert this to keep it in uppercase "Endpoint" so no breaking change to GA version. @heaths, Is that OK?