diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiDescription.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiDescription.java
index 204d6f4776ad5d7bf0b7a60832aede670149970e..df89db8dec49d8bc5d4578701df89089e0f8cdd0 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiDescription.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiDescription.java
@@ -33,10 +33,23 @@ public interface IManagedUiDescription extends ISerializable
      */
     void useTableOutput(ITableModel tableModel);
 
-    IManagedUiAction addAction(String name);
-
+    /**
+     * Adds a table action with given name to actions that can be performed in the user interface
+     * for modification of the managed property.
+     */
     IManagedUiTableAction addTableAction(String name);
 
+    /**
+     * Adds an action with given <var>name</var> to actions that can be performed in the user
+     * interface for modification of the managed property.
+     * <p>
+     * NOTE: currently there is only support for table actions
+     */
+    IManagedUiAction addAction(String name);
+
+    /**
+     * Get all actions defined for the managed property.
+     */
     List<IManagedUiAction> getActions();
 
     /**
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/EntityLinkElementKind.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/EntityLinkElementKind.java
index f40f4816410a3f21d9712227035ab7a270ed5f59..637a59ab57daf5a01ed7da674daf6abe765e282b 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/EntityLinkElementKind.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/EntityLinkElementKind.java
@@ -19,7 +19,7 @@ package ch.systemsx.cisd.openbis.generic.shared.managed_property.api;
 /**
  * The type of an entity link.
  * <p>
- * <b>All methods of this enum are part of the Managed Properties API.</b>
+ * NOTE: This enumeration is part of the Managed Properties API.
  * 
  * @author Kaloyan Enimanev
  */