Existing Wording
The composition section defines a section (or sub-section) of the document, but unlike in CDA, the section content is actually a reference to another resource that actually holds both the narrative and data content for the section. This design means that the narrative and data can be reused in many other ways. Note that the most common resource to use for the content of a section is the List resource.

Proposed Wording
The composition section defines a section (or sub-section) of the document. Like CDA, the section contains the human readable narrative (text). It will also contain a set of references to the underlying resources that were used to construct the text. This design supports the reuse of resources while enabling the construction of authenticated text within documents.

A composition can be authenticated as needed and when dealing with a narrative document, the composition as a whole needs to be reviewed.

Comments
The current design enables both a single resource or a list as the sole content item in a given Section. If a document is sent with a single resource and then updated to remove the item, a list will need to be utilized to indicate the emptyReason. If a document is sent with a single item, and then updated to add additional items, a list will need to be used to enable the processing. This optionality serves no beneficial purpose and can be eliminated by simply extending the section to support text like CDA. (See Diagrams tab for proposed revision)

Grahame's Comments
Add documentation to make clear that a List must be used whenever there is a possibility of either 0 mor more than 1 item. Having a non-list resource directly referenced can only occur if there is guaranteed to be exactly one resource if the section is present

Disposition
Persuasive with mod

Disposition Comment
Add documentation to make clear that a List must be used whenever there is a possibility of either 0 mor more than 1 item. Having a non-list resource directly referenced can only occur if there is guaranteed to be exactly one resource if the section is present