Merge pull request #389 from Nictiz/MM-4882

MM-4882: Corrected description and purpose in ext-TimeInterval.Period

resources/zib/ext-TimeInterval.Duration.xml

@@ -14,8 +14,8 @@
       <use value="work" />
     </telecom>
   </contact>
-  <description value="The duration of the interval in appropriate units of time (e.g. days or hours, etc.)." />
-  <purpose value="This extension represents the Duration concept of the Dutch zib ('Zorginformatiebouwsteen', i.e. Health and Care Information Model) [TimeInterval v1.0 (2020EN)](https://zibs.nl/wiki/TimeInterval-v1.0(2020EN))." />
+  <description value="An extension to provide the Duration concept of zib TimeInterval." />
+  <purpose value="This extension can be used to represent the Duration concept of the Dutch zib ('Zorginformatiebouwsteen', i.e. Health and Care Information Model) [TimeInterval v1.0 (2020EN)](https://zibs.nl/wiki/TimeInterval-v1.0(2020EN)).&#xD;&#xA;&#xD;&#xA;Please note: this extension should not be added to profiles in isolation, but via either the [zib-TimeInterval](http://nictiz.nl/fhir/StructureDefinition/zib-TimeInterval) profile or the [ext-TimeInterval.Period](http://nictiz.nl/fhir/StructureDefinition/ext-TimeInterval.Period) extension. See the documentation on these resources for more information." />
   <copyright value="Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise." />
   <fhirVersion value="4.0.1" />
   <mapping>

resources/zib/ext-TimeInterval.Period.xml

@@ -14,8 +14,8 @@
       <use value="work" />
     </telecom>
   </contact>
-  <description value="An extension to provide the StartDateTime and EndDateTime of zib TimeInterval." />
-  <purpose value="This extension represents the startDateTime and endDateTime concepts of the Dutch zib ('Zorginformatiebouwsteen', i.e. Health and Care Information Model) [TimeInterval v1.0 (2020EN)](https://zibs.nl/wiki/TimeInterval-v1.0(2020EN)).&#xD;&#xA;&#xD;&#xA;Because some host resources natively support the _Period_ data type, it has been chosen not to make a complex extension representing all concepts of the zib. When the host resource supports the _Period_ data type, the &lt;http://nictiz.nl/fhir/StructureDefinition/zib-TimeInterval&gt; data type profile can be used on it, otherwise the current extension should be added. The &lt;http://nictiz.nl/fhir/StructureDefinition/ext-TimeInterval.Duration&gt; extension should be added on the same level as the element containing the _Period_." />
+  <description value="An extension to provide all concepts of zib TimeInterval, to be used in resources where none of these concepts are natively supported." />
+  <purpose value="This extension is one of the three StructureDefinitions that can be used to represent the Dutch (partial) zib ('Zorginformatiebouwsteen', i.e. Health and Care Information Model) [TimeInterval v1.0 (2020EN)](https://zibs.nl/wiki/TimeInterval-v1.0(2020EN)). &#xD;&#xA;&#xD;&#xA;This zib is represented in FHIR by a combination of two datatypes: _Period_ and _Duration_. To support this zib across different FHIR resource types, three related StructureDefinitions are provided:&#xD;&#xA;&#xD;&#xA;* [ext-TimeInterval.Duration](http://nictiz.nl/fhir/StructureDefinition/ext-TimeInterval.Duration): extension to provide the _Duration_ datatype to resource types where no element with this datatype isn't normally available. This extension should not be used in isolation, but only via one of the two resources described below!&#xD;&#xA;* [zib-TimeInterval](http://nictiz.nl/fhir/StructureDefinition/zib-TimeInterval): profile on the _Period_ datatype that defines mappings to zib TimeInterval and brings in the ext-TimeInterval.Duration extension mentioned above. For resource types that natively support an element of the _Period_ datatype but not of the _Duration_ datatype, this profile should be used.&#xD;&#xA;* [ext-TimeInterval.Period](http://nictiz.nl/fhir/StructureDefinition/ext-TimeInterval.Period) (this extension): extension to provide the _Period_ datatype plus the _Duration_ extension mentioned above, with mappings to zib TimeInterval. For resource types that support neither elements of datatype _Period_ nor _Duration_, this extension should be used. *Note*: In hindsight the name of this extension is confusing, 'ext-TimeInterval' would have been better suited.&#xD;&#xA;* *Note*: when the resource type natively supports elements of datatype _Period_ and _Duration_, the zib should be mapped onto these elements directly." />
   <copyright value="Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise." />
   <fhirVersion value="4.0.1" />
   <kind value="complex-type" />

resources/zib/zib-TimeInterval.xml

@@ -15,7 +15,7 @@
     </telecom>
   </contact>
   <description value="A time interval indicates the time between two moments in time. Interval can be defined by a start time and end time, start time and duration or duration and end time." />
-  <purpose value="This Period data type represents the Dutch zib ('Zorginformatiebouwsteen', i.e. Health and Care Information Model) [TimeInterval v1.0 (2020EN)](https://zibs.nl/wiki/TimeInterval-v1.0(2020EN))." />
+  <purpose value="This Period datatype profile is one of the three StructureDefinitions hat can be used to represent the Dutch (partial) zib ('Zorginformatiebouwsteen', i.e. Health and Care Information Model) [TimeInterval v1.0 (2020EN)](https://zibs.nl/wiki/TimeInterval-v1.0(2020EN)). &#xD;&#xA;&#xD;&#xA;This zib is represented in FHIR by a combination of two datatypes: _Period_ and _Duration_. To support this zib across different FHIR resource types, three related StructureDefinitions are provided:&#xD;&#xA;&#xD;&#xA;* [ext-TimeInterval.Duration](http://nictiz.nl/fhir/StructureDefinition/ext-TimeInterval.Duration): extension to provide the _Duration_ datatype to resource types where no element with this datatype isn't normally available. This exentions should not be used in isolation, but only via one of the two resources described below!&#xD;&#xA;* [zib-TimeInterval](http://nictiz.nl/fhir/StructureDefinition/zib-TimeInterval) (this profile): profile on the _Period_ datatype that defines mappings to zib TimeInterval and brings in the ext-TimeInterval.Duration extension mentioned above. For resource types that natively support an element of the _Period_ datatype but not of the _Duration_ datatype, this profile should be used.&#xD;&#xA;* [ext-TimeInterval.Period](http://nictiz.nl/fhir/StructureDefinition/ext-TimeInterval.Period) (this extension): extension to provide the _Period_ datatype plus the _Duration_ extension mentioned above, with mappings to zib TimeInterval. For resource types that support neither elements of datatype _Period_ or _Duration_, this extension should be used. *Note*: In hindsight the name of this extension is confusing, 'ext-TimeInterval' would have been better suited.&#xD;&#xA;* *Note*: when the resource type natively supports elements of datatype _Period_ and _Duration_, the zib should be mapped onto these elements directly." />
   <copyright value="Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise." />
   <fhirVersion value="4.0.1" />
   <mapping>