Class definition Advanced section -- never seems available.

bgrommes

I have various classes in the shared section of the solution, and all of them seem to have the advanced section controls greyed out:

When is this available? The occasion was the thought that I would put a brief description of the class in "Message:" which I assume is to generate the intellisense-like tooltip when you hover over instance variables or whatever. I can't find anything in the docs about "Message:".

This is not a big deal since I can just add a note at the class level, as I'm more interested in documenting my design thoughts as they evolve than in a brief summary -- although that would be nice, too. it is just that if the advanced section doesn't apply at all maybe it shouldn't even be shown.

Garry

You’re right, the UI is misleading here.

The Generics field is available for ordinary classes and interfaces, and the Deprecated checkbox is also available. The field labelled Message only becomes enabled after Deprecated is selected because it contains optional deprecation guidance, such as “Use NewThing instead.” It isn’t a general class description.

I’ve renamed it Deprecation message throughout Studio and updated the documentation. The change will be included in the next release: Deprecation message fields are labelled clearly.

For documenting evolving design thoughts, a Note is currently the right choice. Member descriptions are also available for properties, constants, methods, and events, but Studio doesn’t currently provide an equivalent description field for the class itself.