...
The description field within a path operation may provide example calls or usages of the operation.
...
The tags field within a path operation is used to group operations logically into categories or topics, such as Account, Payments, Reports, Search, etc.
Operation Parameters
The description field within an operation parameter MUST be present and non-empty.
Operation Responses
Each Operation must have at least one successful (i.e. 2xx) response defined.
Each Operation must should define a default response that covers responses not specifically defined for the Operation.
...