#OAS
`description`に説明を添える。[enumに説明用のannotationを追加してほしいというIssue]は挙がっているが実現されていない。
```yaml:openapi.yaml
gender:
type: string
title: 性別
description: |
説明
* `man` - 男性
* `woman` - 女性
enum:
- "man"
- "woman"
```
[enumに説明用のannotationを追加してほしいというIssue]: https://github.com/OAI/OpenAPI-Specification/issues/348