Add doc_id

Author: lcawl

docs/overlays/elasticsearch-openapi-overlays.yaml

@@ -392,6 +392,7 @@ actions:
           examples:
             indicesLegacyPutTemplateRequestExample1:
               $ref: "../../specification/indices/put_template/indicesPutTemplateRequestExample1.yaml"
+## Examples for search applications
   - target: "$.paths['/_application/search_application/{name}/_render_query']['post']"
     description: "Add examples for render search application query operation"
     update:

output/schema/schema.json

@@ -29,6 +29,7 @@ import { SearchApplicationParameters } from '../_types/SearchApplicationParamete
  * You must have `read` privileges on the backing alias of the search application.
  * @rest_spec_name search_application.render_query
  * @availability stack since=8.9.0 stability=experimental visibility=public
+ * @doc_id search-render-query
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/search_application/render_query/SearchApplicationsRenderQueryRequest.ts

@@ -1,6 +1,6 @@
 # summary:
 # method_request: POST _application/search_application/my-app/_render_query
-# description:
+description: Run `POST _application/search_application/my-app/_render_query` to generate a query for a search application called `my-app` that uses the search template.
 # type: request
 value:
   params: