Limiting the length of parameters description forces us to be more concise in how we describe each parameter, while keeping our documentation and other ways descriptions show up in discovery and portals more consistent
OpenAPI Components Parameters Description Length Error
Message: Parameters Description MUST Be Less Than 500 Characters
Policies
Parameter Descriptions
Parameter descriptions tell consumers what each input actually means and how to use it. Without good descriptions, parameters are just names that people have to reverse-engineer.