Narrative refers to model instances by markup in text

https://kerfors.github.io/usdm-overlay/id/finding/narrative-references-by-markup

In the published examples, NarrativeContentItem.text refers to model instances by usdm:ref elements inside the XHTML string, each naming a class (klass), an instance (id) and one attribute. The reference runs from the section to one attribute value. dataStructure.yml does not mention the convention.

standing
For discussion: Rests on the published example files, which are not mature study definitions.
evidence
Example-observed
holds
true
observation
Alexion_NCT04573309_Wilsons.json: 467 usdm:ref in 105 narrative items, 17 classes; CDISC_Pilot_Study.json: 350 usdm:ref in 85 narrative items, 14 classes; EliLilly_NCT03421379_Diabetes.json: 234 usdm:ref in 112 narrative items, 16 classes; devices.json: 41 usdm:ref in 133 narrative items, 14 classes; observational.json: 26 usdm:ref in 6 narrative items, 11 classes. dataStructure.yml mentions usdm:ref: no.
about
NarrativeContentItem
sources
https://github.com/cdisc-org/DDF-RA/blob/v4.0.0/Deliverables/UML/dataStructure.yml
https://github.com/cdisc-org/DDF-RA/tree/v4.0.0/Documents/Examples

Test

Check function narrative_references_by_markup in scripts/check_findings.py.