diff --git a/include/widgets/separator.h b/include/widgets/separator.h
index f1bf7044..c2406a2f 100644
--- a/include/widgets/separator.h
+++ b/include/widgets/separator.h
@@ -7,6 +7,8 @@
  * @defgroup separator separator
  * @ingroup widgets
  *
+ * Displays a horizontal separator line. The height of the widget determines the line width.
+ *
  * @{
  */
 typedef struct _separator   separator;
diff --git a/include/widgets/widget.h b/include/widgets/widget.h
index 2e92f316..8664c864 100644
--- a/include/widgets/widget.h
+++ b/include/widgets/widget.h
@@ -7,7 +7,11 @@
 /**
  * @defgroup widgets widgets
  *
- * Generic widget class
+ * Generic abstract widget class. Widgets should 'inherit' from this class (first structure in there structure should be
+ * widget).
+ * The generic widget implements generic functions like get_width, get_height, draw, resize, update, free and
+ * clicked.
+ * It also holds information about how the widget should be packed.
  *
  * @{
  */