What is the usage recommendation for class?

[modelica-trac-importer]

Since 09e4eae, in ModelicaReference.Classes.'class' the usage recommendation of "class" is given by

"class" should only be used to define ExternalObject

However, "class" is frequently used troughout MSL, ModelicaServices and ModelicaReference as non-specialized class with annotation DocumentationClass=true.

The DocumentationClass annotation was controversially discussed and introduced in #1062 (back in 2013 for MLS 3.2r2), but as 09e4eae originates from 2010, I believe it was overlooked to adapt the class recommendation for ModelicaReference.

---

Migrated-From: https://trac.modelica.org/Modelica/ticket/2128

[akloeckner]

This is related to: #1860

[HansOlsson]

Ok, I understand it now: unless/until we have a specialized documentation-class then "class" seems like the preferred option for a documentation-class, and the ModelicaReference should indicate that.