Comments and annotations should start with a capital letter, for example:
parameter Real a = 1 "Arbitrary factor";
.
For Boolean parameters, the description string should start with "= true, …", for example:
parameter Boolean useHeatPort = false "= true, if heatPort is enabled";
.