Having a paragraph or two description of each API operation helps API consumers understand what is possible with each API request
OpenAPI Operations Description Error
Message: Operation MUST Have Description
Policies
Description of API Operations
Operation descriptions are where you explain what each endpoint actually does. A missing or weak description means consumers have to guess, and guessing leads to bad integrations.