Let’s say I have a model “Person” with all its properties. The model has its description for example: “Representing a human being in the system with all its properties”.
Let’s say I have a model “Car” which (among others) have “owner” and “principleDriver” properties. Both referencing to the Person entity.
When I document the car model, I want to be able to explain that “owner” is “The person who owns the car” (representing the ROLE of this person in regards to the car). What happens today is that the property description is ignored (actually deleted after I set it).