Schema properties should have descriptions that provide a narrative of the property contains, and how it can be used
OpenAPI Schema Properties Descriptions Info
Message: Schema Properties Have Description
Policies
Schema Property Descriptions
Property descriptions explain what each field means in context. This is especially important for fields where the name alone does not tell the full story.