diff --git a/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasMaintainer.java b/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasMaintainer.java
index 604227a..4fb8020 100644
--- a/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasMaintainer.java
+++ b/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasMaintainer.java
@@ -12,7 +12,9 @@ import org.gcube.resourcemanagement.model.impl.relations.consistsof.HasMaintaine
 import org.gcube.resourcemanagement.model.reference.entities.facets.ContactFacet;
 
 /**
- * HasDeveloper indicates that the target ContactFacet contains the information related to a developer of the source resource e.g., the contact points of the developer of a software.
+ * HasDeveloper indicates that the target ContactFacet contains the 
+ * information related to a developer of the source resource, 
+ * e.g., the contact points of the developer of a software.
  * 
  * https://wiki.gcube-system.org/gcube/Facet_Based_Resource_Model#HasMaintainer
  * 
@@ -21,7 +23,7 @@ import org.gcube.resourcemanagement.model.reference.entities.facets.ContactFacet
 @JsonDeserialize(as=HasMaintainerImpl.class)
 @TypeMetadata(
 	name = HasContact.NAME, 
-	description = "HasDeveloper indicates that the target ContactFacet contains the information related to a developer of the source resource e.g., the contact points of the developer of a software.",
+	description = "HasDeveloper indicates that the target ContactFacet contains the information related to a developer of the source resource, e.g., the contact points of the developer of a software.",
 	version = TypeVersion.MINIMAL_VERSION_STRING
 )
 @Change(version = TypeVersion.MINIMAL_VERSION_STRING, description = TypeVersion.MINIMAL_VERSION_DESCRIPTION)
diff --git a/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasOwner.java b/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasOwner.java
index 7a0b924..ec4e6cc 100644
--- a/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasOwner.java
+++ b/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasOwner.java
@@ -13,7 +13,7 @@ import org.gcube.resourcemanagement.model.reference.entities.facets.ContactFacet
 
 /**
  * HasOwner indicates that the target ContactFacet contains the information related to 
- * the owner of the source resource e.g., the contact points of the owner of dataset.
+ * the owner of the source resource, e.g., the contact points of the owner of dataset.
  * 
  * https://wiki.gcube-system.org/gcube/Facet_Based_Resource_Model#HasOwner
  * 
@@ -23,7 +23,7 @@ import org.gcube.resourcemanagement.model.reference.entities.facets.ContactFacet
 @TypeMetadata(
 	name = HasOwner.NAME, 
 	description = "HasOwner indicates that the target ContactFacet contains the information related "
-			+ "to the owner of the source resource e.g., the contact points of the owner of dataset.",
+			+ "to the owner of the source resources, e.g., the contact points of the owner of dataset.",
 	version = TypeVersion.MINIMAL_VERSION_STRING
 )
 @Change(version = TypeVersion.MINIMAL_VERSION_STRING, description = TypeVersion.MINIMAL_VERSION_DESCRIPTION)
diff --git a/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasSpatialCoverage.java b/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasSpatialCoverage.java
index ae59d0c..607de97 100644
--- a/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasSpatialCoverage.java
+++ b/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasSpatialCoverage.java
@@ -12,7 +12,7 @@ import org.gcube.resourcemanagement.model.impl.relations.consistsof.HasSpatialCo
 import org.gcube.resourcemanagement.model.reference.entities.facets.CoverageFacet;
 
 /**
- * HasSpatialCoverage indicates that the target CoverageFacet indicates a spatial coverage information 
+ * HasSpatialCoverage indicates that the target CoverageFacet indicates a spatial coverage information, 
  * e.g., the geographic area indication for the dataset.
  *
  * https://wiki.gcube-system.org/gcube/Facet_Based_Resource_Model#HasSpatialCoverage
@@ -21,7 +21,7 @@ import org.gcube.resourcemanagement.model.reference.entities.facets.CoverageFace
 @JsonDeserialize(as=HasSpatialCoverageImpl.class)
 @TypeMetadata(
 	name = HasSpatialCoverage.NAME, 
-	description = "HasSpatialCoverage indicates that the target CoverageFacet indicates a spatial coverage information e.g., the geographic area indication for the dataset.",
+	description = "HasSpatialCoverage indicates that the target CoverageFacet indicates a spatial coverage information, e.g., the geographic area indication for the dataset.",
 	version = TypeVersion.MINIMAL_VERSION_STRING
 )
 @Change(version = TypeVersion.MINIMAL_VERSION_STRING, description = TypeVersion.MINIMAL_VERSION_DESCRIPTION)
diff --git a/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasTemporalCoverage.java b/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasTemporalCoverage.java
index 224f4dd..39324fc 100644
--- a/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasTemporalCoverage.java
+++ b/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/HasTemporalCoverage.java
@@ -12,8 +12,8 @@ import org.gcube.resourcemanagement.model.impl.relations.consistsof.HasTemporalC
 import org.gcube.resourcemanagement.model.reference.entities.facets.CoverageFacet;
 
 /**
- * HasTemporalCoverage indicates that the target CoverageFacet indicates a temporal coverage information 
- * e.g., the temporal period indication for the dataset.
+ * HasTemporalCoverage indicates that the target CoverageFacet indicates a temporal 
+ * coverage information, e.g., the temporal period indication for the dataset.
  * 
  * https://wiki.gcube-system.org/gcube/Facet_Based_Resource_Model#HasTemporalCoverage
  * 
diff --git a/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/IsIdentifiedBy.java b/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/IsIdentifiedBy.java
index fd643f7..7c8cd2c 100644
--- a/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/IsIdentifiedBy.java
+++ b/src/main/java/org/gcube/resourcemanagement/model/reference/relations/consistsof/IsIdentifiedBy.java
@@ -13,11 +13,13 @@ import org.gcube.informationsystem.utils.TypeVersion;
 import org.gcube.resourcemanagement.model.impl.relations.consistsof.IsIdentifiedByImpl;
 
 /**
- * Each gCube resource has been defined to have at least a Facet linked with an IsIdentifiedBy relation. 
- * IsIdentifiedBy indicates that the target facet represents a sort of identification for the source resource. 
+ * Each gCube resource has been defined to have at least a Facet linked with 
+ * an IsIdentifiedBy relation. 
+ * IsIdentifiedBy indicates that the target facet represents a sort of 
+ * identification for the source resource. 
  * 
- * For instance, a software can consist of one or more SoftwareFacets but the one related with 
- * IsIdentifiedBy represents the identify of the software.
+ * For instance, a software can consist of one or more SoftwareFacets but the one 
+ * related with IsIdentifiedBy represents the identify of the software.
  * 
  * @author Luca Frosini (ISTI - CNR)
  *