From 6be3916fc06c9f043b56a5218b49948ae77723ef Mon Sep 17 00:00:00 2001
From: Sean Fong <sean.fong@csiro.au>
Date: Thu, 22 Aug 2024 10:08:00 +1000
Subject: [PATCH] Fix quantity docs

---
 Conformance.md                             |  2 +-
 documentation/docs/components/quantity.mdx | 11 ++++---
 documentation/docs/sdc/terminology.mdx     | 34 +++++++++++++++++-----
 3 files changed, 35 insertions(+), 12 deletions(-)

diff --git a/Conformance.md b/Conformance.md
index 509e9a2dd..04bda8865 100644
--- a/Conformance.md
+++ b/Conformance.md
@@ -142,7 +142,7 @@ View the source here: http://hl7.org/fhir/uv/sdc/behavior.html
 - [ ] minOccurs
 - [ ] maxOccurs
 - [ ] optionExclusive
-- [ ] unitOption
+- [x] unitOption
 - [ ] unitValueSet
 - [ ] unitOpen
 - [ ] unitSupplementalSystem
diff --git a/documentation/docs/components/quantity.mdx b/documentation/docs/components/quantity.mdx
index 63921a1b4..aa4240565 100644
--- a/documentation/docs/components/quantity.mdx
+++ b/documentation/docs/components/quantity.mdx
@@ -10,6 +10,8 @@ import IframeContainer from '../../src/react/IframeContainer';
 
 There is an extension "http://hl7.org/fhir/StructureDefinition/questionnaire-unit" that can be used to define what unit should be captured (or the unit that has a ucum conversion from the provided unit).
 
+You can use the [UnitOption](/docs/sdc/terminology#unitoption) extension to specify a list of options for the unit of a quantity item.
+
 :::warning
 
 This component is not thoroughly tested yet. Please use it with caution.
@@ -24,7 +26,7 @@ This component is not thoroughly tested yet. Please use it with caution.
   <iframe
     src="https://smartforms.csiro.au/storybook/iframe.html?args=&id=component-itemtype-quantity--quantity-basic"
     width="100%"
-    height="100"
+    height="270"
   />
 </IframeContainer>
 
@@ -34,7 +36,7 @@ This component is not thoroughly tested yet. Please use it with caution.
   <iframe
     src="https://smartforms.csiro.au/storybook/iframe.html?args=&id=component-itemtype-quantity--quantity-basic-response"
     width="100%"
-    height="100"
+    height="270"
   />
 </IframeContainer>
 
@@ -46,7 +48,7 @@ This component is not thoroughly tested yet. Please use it with caution.
   <iframe
     src="https://smartforms.csiro.au/storybook/iframe.html?args=&id=component-itemtype-quantity--quantity-unit-option-response"
     width="100%"
-    height="100"
+    height="270"
   />
 </IframeContainer>
 
@@ -56,7 +58,7 @@ This component is not thoroughly tested yet. Please use it with caution.
   <iframe
     src="https://smartforms.csiro.au/storybook/iframe.html?args=&id=component-itemtype-quantity--quantity-calculation"
     width="100%"
-    height="100"
+    height="270"
   />
 </IframeContainer>
 
@@ -83,3 +85,4 @@ This component is not thoroughly tested yet. Please use it with caution.
 | enableWhen           | item.enableWhen                                                                                                                                               |
 | enableBehavior       | item.enableBehavior                                                                                                                                           |
 | text                 | item.text                                                                                                                                                     |
+| unitOption           | http://hl7.org/fhir/R4/extension-questionnaire-unitoption.html                                                                                                |
diff --git a/documentation/docs/sdc/terminology.mdx b/documentation/docs/sdc/terminology.mdx
index 77c74c69b..dfd8004ed 100644
--- a/documentation/docs/sdc/terminology.mdx
+++ b/documentation/docs/sdc/terminology.mdx
@@ -14,18 +14,22 @@ The elements/extensions that fall under this category are:
 - [answerValueSet](http://hl7.org/fhir/uv/sdc/behavior.html#answerValueSet)
 - [answerExpression](http://hl7.org/fhir/uv/sdc/expressions.html#answerExpression)
 
+There is also another extension that can be used to define the unit of a quantity item:
+
+- [unitOption](https://hl7.org/fhir/uv/sdc/behavior.html#unitOption)
+
 :::note
 
-These three mechanisms are mutually exclusive. Only one should appear on the same item.
+The three mechanisms (answerOption, answerValueSet and answerExpression) are mutually exclusive. Only one should appear on the same item.
 
 :::
+Not all components support terminology binding. Only the following components support terminology binding:
 
-Not all components support terminology binding. The following components support Not all components support calculated expressions. The following components support calculated expressions::
-
-| Components  |
-| ----------- |
-| choice      |
-| open-choice |
+| Components                |
+| ------------------------- |
+| choice                    |
+| open-choice               |
+| quantity (via unitOption) |
 
 ### AnswerOption
 
@@ -155,3 +159,19 @@ Support for this extension is not thoroughly tested yet.
     height="500"
   />
 </IframeContainer>
+
+### UnitOption
+
+UnitOption is used to specify a list of possible units to a [Quantity](/docs/components/quantity) question.
+
+This can be used when the unit is not fixed, and allows the user to choose from a list of units.
+
+#### Basic usage
+
+<IframeContainer storyUrl="https://smartforms.csiro.au/storybook/index.html?path=/story/component-itemtype-quantity--quantity-unit-option-response">
+  <iframe
+    src="https://smartforms.csiro.au/storybook/iframe.html?args=&id=component-itemtype-quantity--quantity-unit-option-response"
+    width="100%"
+    height="270"
+  />
+</IframeContainer>