[bugfix] Changed examples in terms dictionary to yaml and better explained user how to use a dict.

schemas/TermsDictionary.yaml

@@ -1,6 +1,6 @@
 description: |-
-  Provides definitions of codes used in the rest of this response.
+  Provides definitions of codes used in the rest of this response. Only codes used in the response messages are added to the dictionary. For example: if the response doesn't enclose measurements, then these are not in the dictionary. If the response holds feat codes 12001 and 12004, but not 12011, then the dictionary holds 12001 and 12004, but not 12011.
-  
+
   Always sent first.
 type: object
 properties:
@@ -13,24 +13,19 @@ properties:
       value of such a measurement can be looked up in the `nhgAnswers` entry.
     type: object
     additionalProperties: true
-    example: |-
+    example: 
-      {
+      "DMHBTZ":
-        "DMHBTZ": {
+        "num": 2206
-          "num": 2206,
+        "text": "hoofdbehandelaar diabetes"
-          "text": "hoofdbehandelaar diabetes",
+        "nhgVal": true
-          "nhgVal": true
-        }
-      }
   nhgAnswers:
     description: |-
       Enumerated NHG answers (the answer to any measurements with `"nhgVal": true`) can be looked up here.
     type: object
     additionalProperties: true
-    example: |-
+    example: 
-      {
+      "48": "Huisarts"
-        "48": "Huisarts",
+      "49": "Specialist"
-        "49": "Specialist"
-      }
   icpcs:
     description: |-
       Represents diagnoses and medical conditions, based on the ICPC1.1-NL standard. Keys in this object represent ICPC codes, always
@@ -39,25 +34,18 @@ properties:
       containing the dutch human readable name of the class (the letter).
     type: object
     additionalProperties: true
-    example: |-
+    example:
-      {
+      "T90.02":
-        "T90.02": {
+        "text": "Diabetes mellitus type 2"
-          "text": "Diabetes mellitus type 2",
+        "classText": "Endocriene klieren/metabol./voeding"
-          "classText": "Endocriene klieren/metabol./voeding"
-        }
-      }
   atcs:
     description: |-
       Represents medications, mapping ATC codes to value objects containing one k/v pair: `"text"` to a dutch human readable
       description of the medication. The ATC codes may represent groups of medications (less than 7 characters).
     type: object
     additionalProperties: true
-    example: |-
+    example:
-      {
+      "A02AB":
-        "A02AB": {
+        "text": "Aluminiumverbindingen"
-          "text": "Aluminiumverbindingen"
+      "A11GA01":
-        },
+        "text": "Ascorbinezuur"
-        "A11GA01": {
-          "text": "Ascorbinezuur"
-        }
-      }