This is a seemingly simple question that maybe someone can help me with: the <aura:registerEvent /> tag has a "description" attribute. Based on the way other tags are documented (e.g. <aura:attribute />, <aura:method />, etc.), I would expect the text from the description field to show up in the component documentation when you view your org's component library - specifically in the "Specification" tab, where attributes and methods and their descriptions are shown.
However, registered events don't seem to show up here. Which begs the question, where is the description text ever displayed, if not here? And if the event is not documented in the component specification, how will consumers of the component know there's an event they can handle? Sure, you can put a note about it in the "Documentation" tab, but it stands to reason that it should be documented in the specification section as well.
Can anyone provide any insight on this? Am I missing something perhaps?
Thanks in advance.