I looked in past ideas but could not find this specific one so I am posting it here.
Could Mendix add Documentation fields in the properties of all UI items?
This would allow us to document why these UI elements are present, do certain things, or not etc.
Icing on the cake would then be that there would maybe be a Page Documentation tab, just like the new Page Explorer, where one could see all the documentation items?