I’ve got an existing and complex base, and want to add some useful documentation. I can see from questions like this - Metadata API for schema and mutating tables that is has been a topic for some time. Documentation is significantly more useful when it is to hand, i.e. you don’t have to go somewhere else to find it; it should be available where you are looking.
Therefore - If this gets anywhere near a product suggestion:
I would like to be able to rightclick on a table/field/link name and be able to add a text description.
Then when mouseing over these names, a clickable icon would show where descriptions have been added.