Schema should have descriptions that provide a narrative of what a schema object is for, and how it can be used, leaving examples to demonstrate what can actually be expected
OpenAPI Schema Description Error
Message: Schema MUST Have a Description.
Policies
Schema Descriptions
Schema descriptions tell consumers what each data structure represents. Without them, people are left reading property names and trying to infer the meaning of the whole object.