openai
Update summary field name to description in info objects
This PR updates summary field names to description in info objects.
The OpenAPI specification indeed specifies:
| Field Name | Type | Description |
|---|---|---|
| summary | string | A short summary of the API. |
| description | string | A description of the API. CommonMark syntax MAY be used for rich text representation. |
As multiple current summary fields include Markdown descriptions, this change makes it possible to nicely render the definition file in standard vendor tooling on the market. Example: https://bump.sh/christophedujarric/doc/openai
@ChristopheDujarric https://bump.sh/christophedujarric/doc/openai is nothing short of a piece of art. I wish all API references were as clean and beautiful this one.
@ChristopheDujarric I've sent you a PR to your branch with another commit renaming the existing Operation#x-oaiMeta.name properties to the OpenAPI specified Operation#summary which will help to have some better titles in your generated documentation :)
