From 5cafc9cbca7ca3649fd5f37c94cc98263444061a Mon Sep 17 00:00:00 2001
From: cookeac <andrew.cooke@rezare.co.nz>
Date: Mon, 20 May 2024 17:09:16 +0200
Subject: [PATCH] Finished description improvements in
 icarMilkingVisitEventResource

Added descriptions to improve documentation, especially about certified milk weight.
Resolves #444
---
 resources/icarMilkingVisitEventResource.json | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/resources/icarMilkingVisitEventResource.json b/resources/icarMilkingVisitEventResource.json
index ffe7b3f..877da68 100644
--- a/resources/icarMilkingVisitEventResource.json
+++ b/resources/icarMilkingVisitEventResource.json
@@ -24,14 +24,16 @@
           "$ref": "../types/icarMilkDurationType.json"
         },
         "milkingType": {
+          "description": "This code allows organisations to distinguish between manual and automated milking.",
           "$ref": "../enums/icarMilkingTypeCode.json"
         },
         "milkingMilkWeight": {
+          "description": "A certified milking weight that complies with the ICAR guidelines.",
           "$ref": "../types/icarMilkingMilkWeightType.json"
         },
         "milkingComplete": {
           "type": "boolean",
-          "description": "indication whether this milking was completed normally"
+          "description": "indication whether this milking was completed normally."
         },
         "milkingParlourUnit": {
           "type": "string",
@@ -43,7 +45,7 @@
         },
         "milkingDeviceId": {
           "type": "string",
-          "description": "The ID of the device where the milking took place"
+          "description": "The ID of the device where the milking took place."
         },
         "measureDeviceId": {
           "type": "string",
@@ -58,18 +60,21 @@
           "description": "For milkings supervised by humans, this number represents the shift within a local date in which this milking visit occurred." 
         },
         "quarterMilkings": {
+          "description": "A set of milking results for up to four quarters in dairy cows, or two teats for sheep or goats.",
           "type": "array",
           "items": {
             "$ref": "../types/icarQuarterMilkingType.json"
           }
         },
         "animalMilkingSample": {
+          "description": "An array of zero or more sample/bottle details if the animal is milk tested at this milking.",
           "type": "array",
           "items": {
             "$ref": "../types/icarAnimalMilkingSampleType.json"
           }
         },
         "milkCharacteristics": {
+          "description": "An array of milk characteristics other than certified milk weight. See icarMilkCharacteristicsType for documentation.",
           "type": "array",
           "items": {
             "$ref": "../types/icarMilkCharacteristicsType.json"