diff --git a/src/plasmaquick/dialog.h b/src/plasmaquick/dialog.h
index 003da876d..10ec0cd85 100644
--- a/src/plasmaquick/dialog.h
+++ b/src/plasmaquick/dialog.h
@@ -54,9 +54,11 @@ class DialogPrivate;
 
 /**
  * @class Dialog
- * @short QML wrapper for dialogs
  *
- * Exposed as `Dialog` inside org.kde.plasma.core 2.0
+ * Dialog creates a Plasma themed top level window that can contain any QML component.
+ *
+ * It can be automatically positioned relative to a visual parent
+ * The dialog will resize to the size of the main item
  *
  * @code{.qml}
  *  import QtQuick 2.0