While I fully support your efforts to make better tooling, UML is the poster child for this.

I highly encourage people working in this space to revisit those lessons.

Obviously if you find a new way to work around the limitations please run with it.

But limited scope, and targeted simplifications is the only way I have found, over application by trying to describe everything almost always ends up being more harmful in my experience.