## Problem Certain parameter descriptions present in the TypeScript files are not displayed in the API docs, and they are also not included in the OpenAPI spec. ## Example This is how the generated docs look like for the [Cohere inference endpoint docs](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put-cohere#operation-inference-put-cohere-body-application-json-service): <img width="337" height="103" alt="Image" src="https://github.com/user-attachments/assets/41dfbe13-2f7a-4302-b3cc-9c4739e4a005" /> And this is the description in the [TS file](https://github.com/elastic/elasticsearch-specification/blob/f1534e287bbb5e6b2c3d423558af5730d0634e3e/specification/inference/put_cohere/PutCohereRequest.ts#L74): ``` The type of service supported for the specified task type. In this case, `cohere`. ``` `service` is an enum and its value is `cohere`. It seems the description is stripped down and only the enum value is displayed as the description is missing in the OpenAPI spec. ``` "service": { "$ref": "#/components/schemas/inference._types.CohereServiceType" ``` and this is the `CohereServiceType`: ``` "inference._types.CohereServiceType": { "type": "string", "enum": [ "cohere" ] }, ``` Would it be possible to also include the description of the parameter in the OpenAPI file, so it can be displayed in the generated documentation?