Schema property descriptions should be single paragraph narratives about what a schema property represents as one part of an overall digital object being passed to an API or returned from an API. Schema property descriptions should be simple and plain language, leaving examples, patterns, and other elements to the other schema properties available.
Don’t be afraid to let your teams be creative with property descriptions, using AI to generate simple descriptions, and reuse similar properties used in popular 3rd-party APIs. The descriptions of schema properties will be distributed as part of documentation, used as tooltips, and baked into IDE intellisense, so try and make them as useful as possible.