diff --git a/src/lib/ecore/efl_boolean_model.eo b/src/lib/ecore/efl_boolean_model.eo
index 049344d2bb..48eab607c4 100644
--- a/src/lib/ecore/efl_boolean_model.eo
+++ b/src/lib/ecore/efl_boolean_model.eo
@@ -1,25 +1,29 @@
 class @beta Efl.Boolean_Model extends Efl.Composite_Model
 {
-   [[Efl boolean model class]]
+   [[@Efl.Model that efficiently stores boolean properties (they can only be $true or $false).
+
+     Internally the values are stored in a compact bit buffer, taking up minimum memory.
+     An example usage is @Efl.Ui.Select_Model.
+   ]]
    methods {
       boolean_add {
-         [[Add a new named boolean property with a defined default value.]]
+         [[Adds a new named boolean property with a default value.]]
          params {
-            @in name: string;
-            @in default_value: bool;
+            @in name: string; [[The name of the new boolean property.]]
+            @in default_value: bool; [[Default value for new boolean property.]]
 	 }
       }
       boolean_del {
-         [[Delete an existing named boolean property]]
+         [[Deletes an existing named boolean property.]]
          params {
-            @in name: string;
+            @in name: string; [[Name of the property to be deleted.]]
 	 }
       }
       boolean_iterator_get {
-         [[Get an iterator that will quickly find all the index with the requested value for a specific boolean.]]
+         [[Gets an iterator that will quickly find all the indices with the requested value for a specific property.]]
          params {
-            @in name: string;
-            @in request: bool;
+            @in name: string; [[The name of the property to examine.]]
+            @in request: bool; [[The value to look for.]]
          }
          return: iterator<ptr(uint64)>; [[The iterator that is valid until any change is made on the model.]]
       }
diff --git a/src/lib/elementary/efl_ui_select_model.eo b/src/lib/elementary/efl_ui_select_model.eo
index 7e6a76c33b..39624da903 100644
--- a/src/lib/elementary/efl_ui_select_model.eo
+++ b/src/lib/elementary/efl_ui_select_model.eo
@@ -3,19 +3,19 @@ class @beta Efl.Ui.Select_Model extends Efl.Boolean_Model
    [[Efl ui select model class]]
    methods {
       selected_get {
-         [[Get an iterator of all the selected child of this model.
+         [[Gets an iterator of all the selected child of this model.
          ]]
          return: iterator<uint64>; [[The iterator gives indices of selected children.
                                      It is valid until any change is made on the model.]]
       }
       unselected_get {
-         [[Get an iterator of all the child of this model that are not selected.
+         [[Gets an iterator of all the child of this model that are not selected.
          ]]
          return: iterator<uint64>; [[The iterator gives indices of unselected children.
                                      It is valid until any change is made on the model.]]
       }
       @property single_selection {
-         [[Define if we support only one exclusive selection at a time when set to $true.
+         [[Defines if we support only one exclusive selection at a time when set to $true.
 
            If disable with $false, it will have the behavior of a multi select mode.
          ]]