Existing Wording: ElementDefinition.definition

Definition:

Provides a complete explanation of the meaning of the data element for human readability. For the case of elements derived from existing elements (e.g. constraints), the definition SHALL be consistent with the base definition, but convey the meaning of the element in the particular context of use of the resource.

ElementDefinition.comment

Comments: If it is possible to capture usage rules using constraints, that mechanism should be used in preference to this element.

Proposed Wording: ElementDefinition.definition

Definition:

Provides a complete explanation of the meaning of the data element for human readability. For the case of elements derived from existing elements (e.g. constraints), the definition SHALL be consistent with the base definition, but convey the meaning of the element in the particular context of use of the resource. (The text you are reading is specified in ElementDefinition.definition.)

ElementDefinition.comment

Comments: If it is possible to capture usage rules using constraints, that mechanism should be used in preference to this element. (The text you are reading is specified in ElementDefinition.comments.)

Comment:

ElementDefinition.short, definition, comment, definition, and requirements would benefit from a more obvious linke to the rendered format. See added parenthetical comments

Summary:

Make rendering of ElementDefinition text elements clearer