From 4c7906fbda91663e0d23da1784309a11ec613911 Mon Sep 17 00:00:00 2001 From: lcawl Date: Tue, 3 Dec 2024 16:02:53 -0800 Subject: [PATCH 1/3] [DOCS] Add synonym operation summaries --- .../synonyms/delete_synonym/SynonymsDeleteRequest.ts | 2 +- .../synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts | 3 ++- specification/synonyms/get_synonym/SynonymsGetRequest.ts | 2 +- .../synonyms/get_synonym_rule/SynonymRuleGetRequest.ts | 3 ++- .../synonyms/get_synonyms_sets/SynonymsSetsGetRequest.ts | 3 ++- specification/synonyms/put_synonym/SynonymsPutRequest.ts | 4 +++- .../synonyms/put_synonym_rule/SynonymRulePutRequest.ts | 3 ++- 7 files changed, 13 insertions(+), 7 deletions(-) diff --git a/specification/synonyms/delete_synonym/SynonymsDeleteRequest.ts b/specification/synonyms/delete_synonym/SynonymsDeleteRequest.ts index 6e6aeeb3ad..ad6e0b7595 100644 --- a/specification/synonyms/delete_synonym/SynonymsDeleteRequest.ts +++ b/specification/synonyms/delete_synonym/SynonymsDeleteRequest.ts @@ -20,7 +20,7 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Deletes a synonym set + * Delete a synonym set. * @rest_spec_name synonyms.delete_synonym * @availability stack since=8.10.0 stability=stable * @availability serverless stability=stable visibility=public diff --git a/specification/synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts b/specification/synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts index ec2af20641..4c095ad1f0 100644 --- a/specification/synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts +++ b/specification/synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts @@ -20,7 +20,8 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Deletes a synonym rule in a synonym set + * Delete a synonym rule. + * Delete a synonym rule from a synonym set. * @rest_spec_name synonyms.delete_synonym_rule * @availability stack since=8.10.0 stability=stable * @availability serverless stability=stable visibility=public diff --git a/specification/synonyms/get_synonym/SynonymsGetRequest.ts b/specification/synonyms/get_synonym/SynonymsGetRequest.ts index 10490a7b04..277ca732b9 100644 --- a/specification/synonyms/get_synonym/SynonymsGetRequest.ts +++ b/specification/synonyms/get_synonym/SynonymsGetRequest.ts @@ -21,7 +21,7 @@ import { Id } from '@_types/common' import { integer } from '@_types/Numeric' /** - * Retrieves a synonym set + * Get a synonym set. * @rest_spec_name synonyms.get_synonym * @availability stack since=8.10.0 stability=stable * @availability serverless stability=stable visibility=public diff --git a/specification/synonyms/get_synonym_rule/SynonymRuleGetRequest.ts b/specification/synonyms/get_synonym_rule/SynonymRuleGetRequest.ts index 5f2116dc59..aaabd51d60 100644 --- a/specification/synonyms/get_synonym_rule/SynonymRuleGetRequest.ts +++ b/specification/synonyms/get_synonym_rule/SynonymRuleGetRequest.ts @@ -20,7 +20,8 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' /** - * Retrieves a synonym rule from a synonym set + * Get a synonym rule. + * Get a synonym rule from a synonym set. * @rest_spec_name synonyms.get_synonym_rule * @availability stack since=8.10.0 stability=stable * @availability serverless stability=stable visibility=public diff --git a/specification/synonyms/get_synonyms_sets/SynonymsSetsGetRequest.ts b/specification/synonyms/get_synonyms_sets/SynonymsSetsGetRequest.ts index 49a7e518b3..68dccb4ff5 100644 --- a/specification/synonyms/get_synonyms_sets/SynonymsSetsGetRequest.ts +++ b/specification/synonyms/get_synonyms_sets/SynonymsSetsGetRequest.ts @@ -20,7 +20,8 @@ import { RequestBase } from '@_types/Base' import { integer } from '@_types/Numeric' /** - * Retrieves a summary of all defined synonym sets + * Get all synonym sets. + * Get a summary of all defined synonym sets. * @rest_spec_name synonyms.get_synonyms_sets * @availability stack since=8.10.0 stability=stable * @availability serverless stability=stable visibility=public diff --git a/specification/synonyms/put_synonym/SynonymsPutRequest.ts b/specification/synonyms/put_synonym/SynonymsPutRequest.ts index c49bb096bd..b4fe1381ea 100644 --- a/specification/synonyms/put_synonym/SynonymsPutRequest.ts +++ b/specification/synonyms/put_synonym/SynonymsPutRequest.ts @@ -21,7 +21,9 @@ import { Id } from '@_types/common' import { SynonymRule } from '../_types/SynonymRule' /** - * Creates or updates a synonym set. + * Create or update a synonym set. + * Synonyms sets are limited to a maximum of 10000 synonym rules per set. + * If you need to manage more synonym rules, you can create multiple synonym sets. * @rest_spec_name synonyms.put_synonym * @availability stack since=8.10.0 stability=stable * @availability serverless stability=stable visibility=public diff --git a/specification/synonyms/put_synonym_rule/SynonymRulePutRequest.ts b/specification/synonyms/put_synonym_rule/SynonymRulePutRequest.ts index 6da2fda220..a661580cf0 100644 --- a/specification/synonyms/put_synonym_rule/SynonymRulePutRequest.ts +++ b/specification/synonyms/put_synonym_rule/SynonymRulePutRequest.ts @@ -21,7 +21,8 @@ import { Id } from '@_types/common' import { SynonymString } from '../_types/SynonymRule' /** - * Creates or updates a synonym rule in a synonym set + * Create or update a synonym rule. + * Create or update a synonym rule in a synonym set. * @rest_spec_name synonyms.put_synonym_rule * @availability stack since=8.10.0 stability=stable * @availability serverless stability=stable visibility=public From 80939ff0b9fd45599baf62d1451d301c212955b9 Mon Sep 17 00:00:00 2001 From: lcawl Date: Tue, 3 Dec 2024 16:08:58 -0800 Subject: [PATCH 2/3] Generate output --- output/openapi/elasticsearch-openapi.json | 19 ++++++---- .../elasticsearch-serverless-openapi.json | 19 ++++++---- output/schema/schema.json | 38 +++++++++---------- 3 files changed, 43 insertions(+), 33 deletions(-) diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json index 8fcde9063e..96826b14e2 100644 --- a/output/openapi/elasticsearch-openapi.json +++ b/output/openapi/elasticsearch-openapi.json @@ -32545,7 +32545,7 @@ "tags": [ "synonyms" ], - "summary": "Retrieves a synonym set", + "summary": "Get a synonym set", "operationId": "synonyms-get-synonym", "parameters": [ { @@ -32613,7 +32613,8 @@ "tags": [ "synonyms" ], - "summary": "Creates or updates a synonym set", + "summary": "Create or update a synonym set", + "description": "Synonyms sets are limited to a maximum of 10000 synonym rules per set.\nIf you need to manage more synonym rules, you can create multiple synonym sets.", "operationId": "synonyms-put-synonym", "parameters": [ { @@ -32687,7 +32688,7 @@ "tags": [ "synonyms" ], - "summary": "Deletes a synonym set", + "summary": "Delete a synonym set", "operationId": "synonyms-delete-synonym", "parameters": [ { @@ -32722,7 +32723,8 @@ "tags": [ "synonyms" ], - "summary": "Retrieves a synonym rule from a synonym set", + "summary": "Get a synonym rule", + "description": "Get a synonym rule from a synonym set.", "operationId": "synonyms-get-synonym-rule", "parameters": [ { @@ -32766,7 +32768,8 @@ "tags": [ "synonyms" ], - "summary": "Creates or updates a synonym rule in a synonym set", + "summary": "Create or update a synonym rule", + "description": "Create or update a synonym rule in a synonym set.", "operationId": "synonyms-put-synonym-rule", "parameters": [ { @@ -32828,7 +32831,8 @@ "tags": [ "synonyms" ], - "summary": "Deletes a synonym rule in a synonym set", + "summary": "Delete a synonym rule", + "description": "Delete a synonym rule from a synonym set.", "operationId": "synonyms-delete-synonym-rule", "parameters": [ { @@ -32874,7 +32878,8 @@ "tags": [ "synonyms" ], - "summary": "Retrieves a summary of all defined synonym sets", + "summary": "Get all synonym sets", + "description": "Get a summary of all defined synonym sets.", "operationId": "synonyms-get-synonyms-sets", "parameters": [ { diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json index 2f460e5736..1988095b81 100644 --- a/output/openapi/elasticsearch-serverless-openapi.json +++ b/output/openapi/elasticsearch-serverless-openapi.json @@ -17726,7 +17726,7 @@ "tags": [ "synonyms" ], - "summary": "Retrieves a synonym set", + "summary": "Get a synonym set", "operationId": "synonyms-get-synonym", "parameters": [ { @@ -17794,7 +17794,8 @@ "tags": [ "synonyms" ], - "summary": "Creates or updates a synonym set", + "summary": "Create or update a synonym set", + "description": "Synonyms sets are limited to a maximum of 10000 synonym rules per set.\nIf you need to manage more synonym rules, you can create multiple synonym sets.", "operationId": "synonyms-put-synonym", "parameters": [ { @@ -17868,7 +17869,7 @@ "tags": [ "synonyms" ], - "summary": "Deletes a synonym set", + "summary": "Delete a synonym set", "operationId": "synonyms-delete-synonym", "parameters": [ { @@ -17903,7 +17904,8 @@ "tags": [ "synonyms" ], - "summary": "Retrieves a synonym rule from a synonym set", + "summary": "Get a synonym rule", + "description": "Get a synonym rule from a synonym set.", "operationId": "synonyms-get-synonym-rule", "parameters": [ { @@ -17947,7 +17949,8 @@ "tags": [ "synonyms" ], - "summary": "Creates or updates a synonym rule in a synonym set", + "summary": "Create or update a synonym rule", + "description": "Create or update a synonym rule in a synonym set.", "operationId": "synonyms-put-synonym-rule", "parameters": [ { @@ -18009,7 +18012,8 @@ "tags": [ "synonyms" ], - "summary": "Deletes a synonym rule in a synonym set", + "summary": "Delete a synonym rule", + "description": "Delete a synonym rule from a synonym set.", "operationId": "synonyms-delete-synonym-rule", "parameters": [ { @@ -18055,7 +18059,8 @@ "tags": [ "synonyms" ], - "summary": "Retrieves a summary of all defined synonym sets", + "summary": "Get all synonym sets", + "description": "Get a summary of all defined synonym sets.", "operationId": "synonyms-get-synonyms-sets", "parameters": [ { diff --git a/output/schema/schema.json b/output/schema/schema.json index 10cc868603..9794230cb1 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -18740,7 +18740,7 @@ "stability": "stable" } }, - "description": "Deletes a synonym set", + "description": "Delete a synonym set.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-synonyms-set.html", "name": "synonyms.delete_synonym", "request": { @@ -18775,7 +18775,7 @@ "stability": "stable" } }, - "description": "Deletes a synonym rule in a synonym set", + "description": "Delete a synonym rule.\nDelete a synonym rule from a synonym set.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-synonym-rule.html", "name": "synonyms.delete_synonym_rule", "request": { @@ -18813,7 +18813,7 @@ "stability": "stable" } }, - "description": "Retrieves a synonym set", + "description": "Get a synonym set.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-synonyms-set.html", "name": "synonyms.get_synonym", "request": { @@ -18848,7 +18848,7 @@ "stability": "stable" } }, - "description": "Retrieves a synonym rule from a synonym set", + "description": "Get a synonym rule.\nGet a synonym rule from a synonym set.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-synonym-rule.html", "name": "synonyms.get_synonym_rule", "request": { @@ -18886,7 +18886,7 @@ "stability": "stable" } }, - "description": "Retrieves a summary of all defined synonym sets", + "description": "Get all synonym sets.\nGet a summary of all defined synonym sets.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/list-synonyms-sets.html", "name": "synonyms.get_synonyms_sets", "request": { @@ -18921,7 +18921,7 @@ "stability": "stable" } }, - "description": "Creates or updates a synonym set.", + "description": "Create or update a synonym set.\nSynonyms sets are limited to a maximum of 10000 synonym rules per set.\nIf you need to manage more synonym rules, you can create multiple synonym sets.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/put-synonyms-set.html", "name": "synonyms.put_synonym", "request": { @@ -18959,7 +18959,7 @@ "stability": "stable" } }, - "description": "Creates or updates a synonym rule in a synonym set", + "description": "Create or update a synonym rule.\nCreate or update a synonym rule in a synonym set.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/put-synonym-rule.html", "name": "synonyms.put_synonym_rule", "request": { @@ -205461,7 +205461,7 @@ "body": { "kind": "no_body" }, - "description": "Deletes a synonym set", + "description": "Delete a synonym set.", "inherits": { "type": { "name": "RequestBase", @@ -205515,7 +205515,7 @@ "body": { "kind": "no_body" }, - "description": "Deletes a synonym rule in a synonym set", + "description": "Delete a synonym rule.\nDelete a synonym rule from a synonym set.", "inherits": { "type": { "name": "RequestBase", @@ -205553,7 +205553,7 @@ } ], "query": [], - "specLocation": "synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts#L22-L40" + "specLocation": "synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts#L22-L41" }, { "kind": "response", @@ -205581,7 +205581,7 @@ "body": { "kind": "no_body" }, - "description": "Retrieves a synonym set", + "description": "Get a synonym set.", "inherits": { "type": { "name": "RequestBase", @@ -205682,7 +205682,7 @@ "body": { "kind": "no_body" }, - "description": "Retrieves a synonym rule from a synonym set", + "description": "Get a synonym rule.\nGet a synonym rule from a synonym set.", "inherits": { "type": { "name": "RequestBase", @@ -205720,7 +205720,7 @@ } ], "query": [], - "specLocation": "synonyms/get_synonym_rule/SynonymRuleGetRequest.ts#L22-L40" + "specLocation": "synonyms/get_synonym_rule/SynonymRuleGetRequest.ts#L22-L41" }, { "kind": "response", @@ -205748,7 +205748,7 @@ "body": { "kind": "no_body" }, - "description": "Retrieves a summary of all defined synonym sets", + "description": "Get all synonym sets.\nGet a summary of all defined synonym sets.", "inherits": { "type": { "name": "RequestBase", @@ -205788,7 +205788,7 @@ } } ], - "specLocation": "synonyms/get_synonyms_sets/SynonymsSetsGetRequest.ts#L22-L41" + "specLocation": "synonyms/get_synonyms_sets/SynonymsSetsGetRequest.ts#L22-L42" }, { "kind": "response", @@ -205899,7 +205899,7 @@ } ] }, - "description": "Creates or updates a synonym set.", + "description": "Create or update a synonym set.\nSynonyms sets are limited to a maximum of 10000 synonym rules per set.\nIf you need to manage more synonym rules, you can create multiple synonym sets.", "inherits": { "type": { "name": "RequestBase", @@ -205925,7 +205925,7 @@ } ], "query": [], - "specLocation": "synonyms/put_synonym/SynonymsPutRequest.ts#L23-L42" + "specLocation": "synonyms/put_synonym/SynonymsPutRequest.ts#L23-L44" }, { "kind": "response", @@ -205983,7 +205983,7 @@ } ] }, - "description": "Creates or updates a synonym rule in a synonym set", + "description": "Create or update a synonym rule.\nCreate or update a synonym rule in a synonym set.", "inherits": { "type": { "name": "RequestBase", @@ -206021,7 +206021,7 @@ } ], "query": [], - "specLocation": "synonyms/put_synonym_rule/SynonymRulePutRequest.ts#L23-L47" + "specLocation": "synonyms/put_synonym_rule/SynonymRulePutRequest.ts#L23-L48" }, { "kind": "response", From dfd370a7e1863bee51e17d503ff216357c3afa4c Mon Sep 17 00:00:00 2001 From: Lisa Cawley Date: Wed, 4 Dec 2024 16:54:24 -0800 Subject: [PATCH 3/3] Update specification/synonyms/put_synonym/SynonymsPutRequest.ts Co-authored-by: Marci W <333176+marciw@users.noreply.github.com> --- specification/synonyms/put_synonym/SynonymsPutRequest.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/synonyms/put_synonym/SynonymsPutRequest.ts b/specification/synonyms/put_synonym/SynonymsPutRequest.ts index b4fe1381ea..73c8b2eaea 100644 --- a/specification/synonyms/put_synonym/SynonymsPutRequest.ts +++ b/specification/synonyms/put_synonym/SynonymsPutRequest.ts @@ -22,7 +22,7 @@ import { SynonymRule } from '../_types/SynonymRule' /** * Create or update a synonym set. - * Synonyms sets are limited to a maximum of 10000 synonym rules per set. + * Synonyms sets are limited to a maximum of 10,000 synonym rules per set. * If you need to manage more synonym rules, you can create multiple synonym sets. * @rest_spec_name synonyms.put_synonym * @availability stack since=8.10.0 stability=stable