From e6f71a6520d43f21a0cae926c5d67bc7b5544bf7 Mon Sep 17 00:00:00 2001
From: Julia Afeltra <30803904+jafeltra@users.noreply.github.com>
Date: Mon, 15 Apr 2024 14:00:22 -0400
Subject: [PATCH] Document IG.definition extensions on configuration page (#89)

---
 content/docs/SUSHI/configuration/_index.md              | 1 +
 content/docs/SUSHI/configuration/exhaustive-config.yaml | 9 +++++++++
 2 files changed, 10 insertions(+)

diff --git a/content/docs/SUSHI/configuration/_index.md b/content/docs/SUSHI/configuration/_index.md
index 334951e..7938fef 100644
--- a/content/docs/SUSHI/configuration/_index.md
+++ b/content/docs/SUSHI/configuration/_index.md
@@ -142,6 +142,7 @@ The table below lists all configuration properties that can be used in SUSHI's *
 | copyrightLabel| copyrightLabel | As specified in the IG resource - **Note:** this is an R5 IG element |
 | copyrightYear or copyrightyear | N/A | Used to add a `copyrightyear` parameter to `IG.definition.parameter` |
 | date | date | As specified in the IG resource |
+| definition <br> └ extension | definition.extension | <span class="tag">SUSHI 3.0</span>A list of extensions that apply to `IG.definition`. **Note:** the only property supported on the `definition` property is `extension`. |
 | description | description | As specified in the IG resource |
 | dependencies | dependsOn | A `key: value` pair, where key is the package id and value is the version (or `dev`/`current`). For advanced use cases, the value can be an object with keys for `id`, `uri` and `version`. For R5 IG resources, the key `reason` can also be provided. |
 | experimental | experimental | As specified in the IG resource |
diff --git a/content/docs/SUSHI/configuration/exhaustive-config.yaml b/content/docs/SUSHI/configuration/exhaustive-config.yaml
index c2d6fb0..1cc4e9d 100644
--- a/content/docs/SUSHI/configuration/exhaustive-config.yaml
+++ b/content/docs/SUSHI/configuration/exhaustive-config.yaml
@@ -73,6 +73,15 @@ global:
   Patient: http://example.org/fhir/StructureDefinition/my-patient-profile
   Encounter: http://example.org/fhir/StructureDefinition/my-encounter-profile
 
+# NOTE: All of the properties of IG.definition are abstracted to
+# individual top-level configuration properties (below). This
+# definition property should only be used to provide extensions
+# that have a context of IG.definition.
+definition:
+  extension:
+    - url: http://example.org/example/ig-definition-ext
+      valueBoolean: true
+
 # The resources property corresponds to IG.definition.resource.
 # SUSHI can auto-generate all of the resource entries based on
 # the FSH definitions and/or information in any user-provided