Social Farm

globalcoffeeplatform · Jul 26, 2022 · d52deb0 · d52deb0
1 parent 6bfd020
commit d52deb0
Show file tree

Hide file tree

Showing 8 changed files with 41 additions and 59 deletions.
diff --git a/docs/source/_static/schema/accidents.json b/docs/source/_static/schema/accidents.json
@@ -1,4 +1,4 @@
-{
+ {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://raw.githubusercontent.com/globalcoffeeplatform/Delta-DataWarehouse-Documentation/main/schema/accidents.json",
   "title": "Accidents",

diff --git a/docs/source/_static/schema/address.json b/docs/source/_static/schema/address.json
@@ -35,14 +35,12 @@
     "adminAreaLevel2/state/province": {
       "title": "Admin Area Level 2 (state or province)",
       "description": "State Name in ISO 3166-1 Alpha-2 Format. ISO codes of province for a country can be found here https://www.iso.org/obp/ui/#search.",
-      "type": "string",
-      "examples": "BI-RY"
+      "type": "string"
     },
     "adminAreaLevel1/countryName": {
       "title": "Admin Area Level 1 (country name)",
       "description": "Country Name in ISO 3166-1 Alpha-2 Format. List of ISO code of countries can be found here https://www.iso.org/obp/ui/#search.",
-      "type": "string",
-      "examples": "BI"
+      "type": "string"
     }
   },
   "definitions": {

diff --git a/docs/source/_static/schema/farm-location.json b/docs/source/_static/schema/farm-location.json
@@ -10,7 +10,7 @@
   ],
   "properties": {
     "coordinates": {
-      "title": "Front door geolocation, using custom schema",
+      "title": "Coordinate of the fram either captured at the gate/entry or middle of the farm.",
       "description": "Latitude and Longitude Information",
       "type": "array",
       "items": {
@@ -38,16 +38,16 @@
         "maxItems": 2
       }
     },
-    "geoLocation": {
-      "title": "Front door geolocation, using GeoJson schema",
-      "$ref": "./point.json",
-      "additionalProperties": false
-    },
-    "farmShape2": {
-      "title": "Shape of the farm, using GeoJson schema",
-      "$ref": "./polygon.json",
-      "additionalProperties": false
-    },
+    //"geoLocation": {
+    //  "title": "Front door geolocation, using GeoJson schema",
+    //  "$ref": "./point.json",
+    //  "additionalProperties": false
+    //},
+    //"farmShape2": {
+    //  "title": "Shape of the farm, using GeoJson schema",
+    //  "$ref": "./polygon.json",
+    //  "additionalProperties": false
+    //},
     "positionTakenAt": {
       "title": "The position was taken at ..",
       "type": "string",

diff --git a/docs/source/_static/schema/farmData.schema.json b/docs/source/_static/schema/farmData.schema.json
@@ -246,18 +246,18 @@
                     "title": "Location of the farm",
                     "description": "GPS should be captured for each farm plot if possible. GPS readings should be taken outside of buildings and away from significant tree coverage to avoid interference in the signal. GPS should be captured in the middle of the plot, and/or near the entrance to any main building (if there is one). Where the main residence or other buildings are not located on the farm plot, GPS should be taken in the middle of the plot.",
                     "$ref": "./farm-location.json"
-                },
-                "thirdPartyIds": {
-                    "title": "Third-party identifier",
-                    "description": "When this dataset is reused by another organisation that needs to use their own Global Unique Identifier, the original identifier can be saved here, to track history and origin.",
-                    "type": "array",
-                    "uniqueItems": true,
-                    "items": {
-                        "$ref": "./global-unique-id.json"
-                    },
-                    "additionalItems": false,
-                    "additionalProperties": false
                 }
+                //"thirdPartyIds": {
+                //    "title": "Third-party identifier",
+                //    "description": "When this dataset is reused by another organisation that needs to use their own Global Unique Identifier, the original identifier can be saved here, to track history and origin.",
+                //    "type": "array",
+                //    "uniqueItems": true,
+                //    "items": {
+                //        "$ref": "./global-unique-id.json"
+                //    },
+                //    "additionalItems": false,
+                //    "additionalProperties": false
+                //}
             }
         },
         "social-farm": {
@@ -283,12 +283,12 @@
                     "$extended-description": "The approach involves asking for the average daily wage rate paid. If applicable, include wages for coffee production, harvesting, and processing and take an average across all three categories.\\nWage is listed and also expressed as a percentage of the rural minimum wage (where that exists), alternately to the national minimum wage.\\nThis approach gives a good sense of worker earnings coming from the most prominent types of labour without needing to detail individual jobs, rates, benefits, etc.\\nOrganisations may wish to participate in working groups to define and measure living wage. There is still no widely used methodology, but the ability to understand whether a worker could survive on the wage earned would be useful for any industry. ",
                     "$ref": "./wages.json"
                 },
-                "accidents": {
-                    "title": "Accidents",
-                    "description": "TODO description",
-                    "$extended-description": "TODO extended-description",
-                    "$ref": "./accidents.json"
-                }
+              "accidents": {
+                "title": "Accidents",
+                "description": "This indicator tracks the number of fatalities and non-fatalities occurring on farm.",
+                "$extended-description": "Worker health and safety refers to the principle that workers should be protected from sickness, disease and injury arising from their employment.",
+                "$ref": "./accidents.json"
+              }
             }
         },
         "economic-farm": {

diff --git a/docs/source/_static/schema/poverty-level.json b/docs/source/_static/schema/poverty-level.json
@@ -11,7 +11,7 @@
   "properties": {
     "totalHouseholdIncome": {
       "title": "Total household income",
-      "description": "Total household income in USD",
+      "description": "Total household income in Local Currency",
       "type": "number",
       "minimum": 0
     },

diff --git a/docs/source/explanation.rst b/docs/source/explanation.rst
@@ -491,22 +491,6 @@ GPS should be captured for each farm plot if possible. GPS readings should be ta
     <script src="_static/docson/widget.js" data-schema="../schema/farm-location.json"></script>
 
 
-4.8 Third-party identifier
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-.. topic:: Details:
-
-   **Property name**: thirdPartyIds
-
-   **Type**: *array*
-
-   **Unique items**: *True*
-
-   **Array items**: *global-unique-id.json*
-
-
-When this dataset is reused by another organisation that needs to use their own Global Unique Identifier, the original identifier can be saved here, to track history and origin.
-
-
 *****************************
 5 Social farm characteristics
 *****************************
@@ -589,10 +573,10 @@ Organisations may wish to participate in working groups to define and measure li
    **Reference**: *accidents.json*
 
 
-TODO description.
+This indicator tracks the number of fatalities and non-fatalities occurring on farm.
 
 
-TODO extended-description.
+Worker health and safety refers to the principle that workers should be protected from sickness, disease and injury arising from their employment.
 
 
 .. raw:: html

diff --git a/schema/accidents.json b/schema/accidents.json
@@ -1,4 +1,4 @@
-{
+ {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://raw.githubusercontent.com/globalcoffeeplatform/Delta-DataWarehouse-Documentation/main/schema/accidents.json",
   "title": "Accidents",

diff --git a/schema/farmData.schema.json b/schema/farmData.schema.json
@@ -283,12 +283,12 @@
                     "$extended-description": "The approach involves asking for the average daily wage rate paid. If applicable, include wages for coffee production, harvesting, and processing and take an average across all three categories.\\nWage is listed and also expressed as a percentage of the rural minimum wage (where that exists), alternately to the national minimum wage.\\nThis approach gives a good sense of worker earnings coming from the most prominent types of labour without needing to detail individual jobs, rates, benefits, etc.\\nOrganisations may wish to participate in working groups to define and measure living wage. There is still no widely used methodology, but the ability to understand whether a worker could survive on the wage earned would be useful for any industry. ",
                     "$ref": "./wages.json"
                 },
-                "accidents": {
-                    "title": "Accidents",
-                    "description": "TODO description",
-                    "$extended-description": "TODO extended-description",
-                    "$ref": "./accidents.json"
-                }
+              "accidents": {
+                "title": "Accidents",
+                "description": "This indicator tracks the number of fatalities and non-fatalities occurring on farm.",
+                "$extended-description": "Worker health and safety refers to the principle that workers should be protected from sickness, disease and injury arising from their employment.",
+                "$ref": "./accidents.json"
+              }
             }
         },
         "economic-farm": {