a field's description doesn't end up getting shown anywhere in the Schema Definitions if the field ends up being a $ref
Note that the field's description renders just fine if the field is a type (e.g. boolean, integer, string, etc.). It only doesn't show up if the field is a $ref to another schema.