[sapphire-dev] Documentation on Element property

[Shenxue Zhou <shenxue.zhou@xxxxxxxxxx>]

It seems that @Documentation on Element property (either implied element property or explicit element property) is not supported. Documentation has to be done on child properties. For element properties with branches like the following:
 
    @Type
    ( 
        base = IMethodCallOutcome.class, 
        possible = 
        { 
            IFixedOutcome.class, 
            IToStringOutcome.class
        }
    )

Documentation on the element property might be more appropiate since developers can document each branch to give customers an overview on all the options. Another issue is some branches may not contain child properties so it's hard to figure out a place for documentation on those branches.

Another issue is this is not consistent with List properties in which documentation has to be done on List properties rather than on list elements. 

Thoughts?

Thanks,

Shenxue