diff --git a/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/community_infrastructure_schema.json b/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/community_infrastructure_schema.json
index 9fc338224..d2f179212 100644
--- a/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/community_infrastructure_schema.json
+++ b/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/community_infrastructure_schema.json
@@ -4,11 +4,11 @@
   "properties": {
     "description": {
       "type": "string",
-      "description": "Description of the research community/ research infrastructure"
+      "description": "Description of the research community/research infrastructure"
     },
     "id": {
       "type": "string",
-      "description": "OpenAIRE id of the research community/ research infrastructure"
+      "description": "OpenAIRE id of the research community/research infrastructure"
     },
     "name": {
       "type": "string",
@@ -19,20 +19,19 @@
       "description": "The acronym of the community"
     },
     "subject": {
-      "description": "Description of subject",
+      "description": "Only for research communities: the list of the subjects associated to the research community",
       "type": "array",
       "items": {
-        "type": "string",
-        "description": "Only for research communities: the list of the subjects associated to the research community"
+        "type": "string"
       }
     },
     "type": {
       "type": "string",
-      "description": "The type of the record (research community/research infrastructure)"
+      "description": "One of {Research Community, Research infrastructure}"
     },
     "zenodo_community": {
       "type": "string",
-      "description": "The id of the Zenodo communities associated to the research community/Research infrastructure"
+      "description": "The URL of the Zenodo community associated to the Research community/Research infrastructure"
     }
   }
 }
\ No newline at end of file
diff --git a/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/datasource_schema.json b/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/datasource_schema.json
index 3fbb2266e..b9c15d921 100644
--- a/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/datasource_schema.json
+++ b/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/datasource_schema.json
@@ -18,26 +18,26 @@
   "properties": {
     "accessrights": {
       "type": "string",
-      "description": "The database access type: {open, restricted or closed}"
+      "description": "Type of access to the data source, as defined by re3data.org. Possible values: {open, restricted, closed}"
     },
     "certificates": {
       "type": "string",
-      "description": "Description of certificates"
+      "description": "The certificate, seal or standard the data source complies with. As defined by re3data.org."
     },
     "citationguidelineurl": {
-      "type": "string"
+      "type": "string",
+      "description":"The URL of the data source providing information on how to cite its items. As defined by re3data.org."
     },
     "contenttypes": {
-      "description": "OpenDoar specific fileds ",
+      "description": "Types of content in the data source, as defined by OpenDOAR",
       "type": "array",
       "items": {
-        "type": "string",
-        "description": "Description of contenttypes"
+        "type": "string"
       }
     },
     "databaseaccessrestriction": {
       "type": "string",
-      "description": "One of {feeRequired, registration, other}"
+      "description": "Access restrinctions to the data source, as defined by re3data.org. One of {feeRequired, registration, other}"
     },
     "datasourcetype": {
       "allOf": [
@@ -51,7 +51,7 @@
     },
     "datauploadrestriction": {
       "type": "string",
-      "description": "One of {feeRequired, registration, other}"
+      "description": "Upload restrictions applied by the datasource, as defined by re3data.org. One of {feeRequired, registration, other}"
     },
     "dateofvalidation": {
       "type": "string",
@@ -66,7 +66,7 @@
     },
     "id": {
       "type": "string",
-      "description": "The OpenAIRE id of the resource"
+      "description": "The OpenAIRE id of the data source"
     },
     "journal": {
       "type": "object",
@@ -78,15 +78,15 @@
           "type": "string"
         },
         "edition": {
-          "type": "string",
-          "description": "Edition of the journal or conference proceeding"
+          "type": "string"
         },
         "ep": {
           "type": "string",
           "description": "End page"
         },
         "iss": {
-          "type": "string"
+          "type": "string",
+          "description": "Issue number"
         },
         "issnLinking": {
           "type": "string"
@@ -98,21 +98,21 @@
           "type": "string"
         },
         "name": {
-          "type": "string",
-          "description": "Name of the journal or conference"
+          "type": "string"
         },
         "sp": {
           "type": "string",
           "description": "Start page"
         },
         "vol": {
-          "type": "string"
+          "type": "string",
+          "description": "Volume"
         }
       },
-      "description": "Description of journal"
+      "description": "Information about the journal, if this data source is of type Journal."
     },
     "languages": {
-      "description": "OpenDOAR specific field",
+      "description": "The languages present in the data source's content, as defined by OpenDOAR.",
       "type": "array",
       "items": {
         "type": "string"
@@ -122,7 +122,8 @@
       "type": "string"
     },
     "missionstatementurl": {
-      "type": "string"
+      "type": "string",
+      "description":"The URL of a mission statement describing the designated community of the data source. As defined by re3data.org"
     },
     "officialname": {
       "type": "string",
@@ -130,7 +131,7 @@
     },
     "openairecompatibility": {
       "type": "string",
-      "description": "Information about the OpenAIRE compatibility of the ingested results (which guidelines they are compliant to)"
+      "description": "OpenAIRE guidelines the data source comply with. See also https://guidelines.openaire.eu."
     },
     "originalId": {
       "description": "Original identifiers for the datasource"
@@ -140,37 +141,34 @@
       }
     },
     "pid": {
-      "description": "Persistent identifiers for the datasource",
+      "description": "Persistent identifiers of the datasource",
       "type": "array",
       "items": {
         "allOf": [
           {
             "$ref": "#/definitions/ControlledField"
-          },
-          {
-            "description": "Description of pid"
           }
         ]
       }
     },
     "pidsystems": {
       "type": "string",
-      "description": "Description of pidsystems"
+      "description": "The persistent identifier system that is used by the data source. As defined by re3data.org"
     },
     "policies": {
-      "description": "Description of policies",
+      "description": "Policies of the data source, as defined in OpenDOAR.",
       "type": "array",
       "items": {
-        "description": "Description of policies"
+        "type": "string"
       }
     },
     "releaseenddate": {
       "type": "string",
-      "description": "Description of releaseenddate"
+      "description": "Date when the data source went offline or stopped ingesting new research data. As defined by re3data.org"
     },
     "releasestartdate": {
       "type": "string",
-      "description": "Description of releasestartdate"
+      "description": "Releasing date of the data source, as defined by re3data.org"
     },
     "subjects": {
       "description": "List of subjects associated to the datasource",
@@ -181,11 +179,11 @@
     },
     "uploadrights": {
       "type": "string",
-      "description": "One of {open, restricted or closed}"
+      "description": "Type of data upload. As defined by re3data.org: one of {open, restricted,closed}"
     },
     "versioning": {
       "type": "boolean",
-      "description": "Description of versioning"
+      "description": "As defined by redata.org: 'yes' if the data source supports versioning, 'no' otherwise."
     },
     "websiteurl": {
       "type": "string"
diff --git a/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/project_schema.json b/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/project_schema.json
index 6fe11ec0c..c81187258 100644
--- a/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/project_schema.json
+++ b/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/project_schema.json
@@ -10,7 +10,7 @@
     },
     "code": {
       "type": "string",
-      "description": "The grant agreement"
+      "description": "The grant agreement number"
     },
     "enddate": {
       "type": "string"
@@ -54,7 +54,7 @@
       "properties": {
         "currency": {
           "type": "string",
-          "description": "The currency of the granted amount"
+          "description": "The currency of the granted amount (e.g. EUR)"
         },
         "fundedamount": {
           "type": "number",
@@ -62,13 +62,13 @@
         },
         "totalcost": {
           "type": "number",
-          "description": "The total cost"
+          "description": "The total cost of the project"
         }
       },
-      "description": "The funded amount for the project"
+      "description": "The money granted to the project"
     },
     "h2020programme": {
-      "description": "The h2020 programme the project is funded under",
+      "description": "The h2020 programme funding the project",
       "type": "array",
       "items": {
         "type": "object",
diff --git a/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/relation_schema.json b/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/relation_schema.json
index 53cc3238b..7c7de9c98 100644
--- a/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/relation_schema.json
+++ b/dhp-workflows/dhp-graph-mapper/src/main/resources/eu/dnetlib/dhp/oa/graph/dump_whole/schema/relation_schema.json
@@ -26,7 +26,7 @@
         },
         "trust": {
           "type": "string",
-          "description": "The trust of the relation"
+          "description": "The trust of the relation in the range of [0,1]. Where greater the number, more the trust. Harvested relationships have typically a high trust (0.9). The trust of inferred relationship is calculated by the inference algorithm that generated them, as described in https://graph.openaire.eu/about#architecture (Enrichment --> Mining)"
         }
       }
     },
@@ -35,14 +35,14 @@
       "properties": {
         "name": {
           "type": "string",
-          "description": "the semantics of the relation (i.e. isAuthorInstitutionOf)"
+          "description": "The semantics of the relation (i.e. isAuthorInstitutionOf). "
         },
         "type": {
           "type": "string",
           "description": "the type of the relation (i.e. affiliation)"
         }
       },
-      "description": "To represent the semantics of the generic relation between two entities"
+      "description": "To represent the semantics of a relation between two entities"
     },
     "source": {
       "allOf": [