I don't know how difficult this would be, but considering the sometimes dizzying flexibility of the Advanced Alert Manager, it would be nice to have the following documentation feature added in the future.
I would like to be able to construct an advanced alert and then be able to generate a description of exactly how the alert and associated actions will function. Such information as what actions will happen when and under what conditions, what suppressions exist, how escalation options will work, etc.
Ideally, all of this would be presented in text form in plain English - not in some tabular summary format.
Anything is possible, but it's not trivial. I'll certainly consider it.