Community
Participate
Working Groups
In certain cases, it doesn't make sense to specify documentation at property or you end up with unuseful documentation entries like "name of x" or "description of x". To support those cases, we allow documentation to be specified at type level. The intention is that type documentation is appended to property documentation. This works ok when property has documentation, but when property has no documentation, the documentation of the title (property label) does not appear to correspond to the content. If type documentation exists, but property documentation does not exists, we should use type label as opposed to property label for documentation title.
Created attachment 198592 [details] Example of the problem
Implemented the following semantics: if( property documentation or property facts exist ) { set context help title to property label include property documentation and facts if( type documentation exists ) { append type documentation in a separate section with type label as the section title } } else { if( type documentation exists ) { set context help title to type label include type documentation } } Ling, please verify.
Verify with sapphire-gallery extended help. Just noting that the separate section has a different font/color as the main section. But I don't think there is anytime we can do due to limitation of the help UI.
