A trailing question mark, for example description?, indicates an optional property.
Proposed clarification:
remove , for example description?
change sentence to A trailing question mark MAY indicate an optional property.
explicitly mention which properties, in each section, may use such trailing question mark and why, E.g. by adding a sentence starting with A trailing question mark may be used here to ...:
In the "General" sub-section of the Definitions and Terminology section, this statement needs to be clarified:
Proposed clarification:
, for example description?
A trailing question mark MAY indicate an optional property.
A trailing question mark may be used here to ...
:Property Declarations
of an object typeDeclaring HTTP Methods as Optional