Being familiar with graphical modeling tools, I recently thought about the concept of architecture description languages (ADL) where one describes architectures in a textual form in order to comprehensively document it.
I see advantages in this approach since it is a formal definition of an architecture stored in a single place without need to switch between graphical and text editors all the time. Kind of the TeX way of describing architectures.
I have been looking a bit but only found quite dated research material.
Do you have experience with productive usage of an ADL? What works, what does not work?
Is there a toolset available which supports document generation from an ADL? Including rendering images of the architecture, describing components and interfaces and component hierachies? And probably even using that to describe dynamic behaviour?