I think it would be better if somebody (@lekkim?) that actually did work with, and thus knows the actual refactoring of the archetypes in question, updated related example template(s) in the CKM. Checking and fixing what breaks in official CKM examples should be a part of the archetype release process.
The old (now broken) template looks like this
What is the new supposed usage pattern? The new version of the Archetype, Evaluation Archetype: Cause of death [openEHR Clinical Knowledge Manager], that the template was based on, does not have a “Death details”-slot. Also there is no longer a “Death details” archetype in the CKM other than the one from PARENT, Cluster Archetype: Death details (PARENT) [openEHR Clinical Knowledge Manager].
I suspect that the “PARENT Death details” is not supposed to go in to the “Additional details” slot of the international CKM “Cause of death” archetype…
…but rather that some other pattern was thought of in the refactoring.
If somebody tells me what pattern would be the best for a template to demonstrate the usage of cause of death etc, then I could either update or make a new example template.
The “Use” section of the “Cause of death” archetype lists three use cases:
- a death certificate or notification, nested within the COMPOSITION.certificate archetype;
- a post mortem report, nested within the COMPOSITION.report-post_mortem archetype, as one of a number of components of a post mortem report; or
- disease registries and epidemiological surveillance, nested within the COMPOSITION.report-case_investigation archetype, as one of a number of components of a case investigation, such as a maternal mortality investigation.
Regarding #3 I can’t find any such “case_investigation” archetype, but there is a openEHR-EHR-COMPOSITION.report-clinical_investigation.v0
Regarding all (#1-#3) none of those enclosing COMPOSTION suggestions contain an obvious place to record time of death - one of the main things the old (now broken) template demonstrated, so an example showing that would likely still be very valuable.
There is a “Death Summary” EVALUATION archetype that contains “Date/time of death” https://ckm.openehr.org/ckm/archetypes/1013.1.5605 should that go into one of the example compositions (#1-#3) as a sibling next to “cause of death”? (Since EVALUATIONS can not be nested in each other.)
If so we should just remove the old example and now (or later) create a new one since I don’t think it is wise to “upgrade” an EVALUATION based template to a COMPOSITION based template without changing the identifier and scope.