diff --git a/src/main/java/org/gcube/resourcemanagement/model/reference/entities/facets/ActionFacet.java b/src/main/java/org/gcube/resourcemanagement/model/reference/entities/facets/ActionFacet.java
index d209759..683d00e 100644
--- a/src/main/java/org/gcube/resourcemanagement/model/reference/entities/facets/ActionFacet.java
+++ b/src/main/java/org/gcube/resourcemanagement/model/reference/entities/facets/ActionFacet.java
@@ -36,16 +36,18 @@ public interface ActionFacet extends Facet, Named {
 	 * Type of action.
 	 * @return an instance of {@link EnumStringProperty}
 	 */
-	@ISProperty(name=TYPE_PROPERTY, mandatory=true, nullable=false)
+	@ISProperty(name=TYPE_PROPERTY, description = "Type of action", mandatory=true, nullable=false)
 	public EnumStringProperty getType();
 	
 	public void setType(EnumStringProperty type);
 	
 	/**
 	 * From where to download the action.
+	 * A remote source used by the command. Could be the endpoint of a service, the location of a 
+	 * remote ansible playbook, etc.
 	 * @return URL or Endpoint
 	 */
-	@ISProperty(mandatory=false, nullable=false)
+	@ISProperty(description = "From where to download the action.", mandatory=false, nullable=false)
 	public String getSource();
 	
 	/**
@@ -59,7 +61,7 @@ public interface ActionFacet extends Facet, Named {
 	 * The options/params to use when executing the action.
 	 * @return the command to execute to lauch the action
 	 */
-	@ISProperty(mandatory=true, nullable=false)
+	@ISProperty(description = "The options/params to use when executing the action.", mandatory=true, nullable=false)
 	public String getOptions();
 
 	/**
@@ -68,15 +70,18 @@ public interface ActionFacet extends Facet, Named {
 	 */
 	public void setOptions(String options);
 
+	/**
+	 * Gets the command to execute.
+	 * @return the command
+	 */
+	@ISProperty(description = "The command to execute.")
+	public String getCommand();
+	
 	/**
 	 * Sets the command to execute.
 	 * @param command
 	 */
 	public void setCommand(String command);
 	
-	/**
-	 * Gets the command to execute.
-	 * @return the command
-	 */
-	public String getCommand();
+	
 }