diff --git a/includes/entity.inc b/includes/entity.inc
index 89903cd..0bd9d42 100644
--- a/includes/entity.inc
+++ b/includes/entity.inc
@@ -17,6 +17,13 @@
  * hook_entity_info(). That way modules are able to override your defaults
  * by altering the hook_entity_info() callbacks, while $entity->label() and
  * $entity->uri() reflect this changes as well.
+ *
+ * Defaults for entity properties can be easily defined by adding class
+ * properties, e.g.:
+ * @code
+ *   public $name = '';
+ *   public $count = 0;
+ * @endcode
  */
 class Entity {