diff --git a/src/client/datadevice.h b/src/client/datadevice.h
--- a/src/client/datadevice.h
+++ b/src/client/datadevice.h
@@ -36,7 +36,7 @@
 class Surface;
 
 /**
- * @short Wrapper for the wl_data_device interface.
+ * @short DataDevice allows clients to share data by copy-and-paste and drag-and-drop.
  *
  * This class is a convenient wrapper for the wl_data_device interface.
  * To create a DataDevice call DataDeviceManager::getDataDevice.
diff --git a/src/client/dpms.h b/src/client/dpms.h
--- a/src/client/dpms.h
+++ b/src/client/dpms.h
@@ -37,9 +37,9 @@
 class Output;
 
 /**
- * @short Wrapper for the org_kde_kwin_dpms_manager interface.
+ * @short This class is a factory for Dpms instances.
  *
- * This class provides a convenient wrapper for the org_kde_kwin_dpms_manager interface.
+ * It is a convenience wrapper for the org_kde_kwin_dpms_manager interface.
  *
  * To use this class one needs to interact with the Registry. There are two
  * possible ways to create the DpmsManager interface:
@@ -57,7 +57,7 @@
  * The DpmsManager can be used as a drop-in replacement for any org_kde_kwin_dpms_manager
  * pointer as it provides matching cast operators.
  *
- * @see Registry
+ * @see Registry, Dpms
  * @since 5.5
  **/
 class KWAYLANDCLIENT_EXPORT DpmsManager : public QObject
@@ -134,8 +134,9 @@
 };
 
 /**
- * @short Wrapper for the org_kde_kwin_dpms interface.
+ * @short Power management for monitors.
  *
+ * Display Power Management Signaling allows power management for monitors.
  * This class is a convenient wrapper for the org_kde_kwin_dpms interface.
  * To create a Dpms call DpmsManager::getDpms.
  *
diff --git a/src/server/datadevice_interface.h b/src/server/datadevice_interface.h
--- a/src/server/datadevice_interface.h
+++ b/src/server/datadevice_interface.h
@@ -38,7 +38,12 @@
 class SurfaceInterface;
 
 /**
- * @brief Represents the Resource for the wl_data_device interface.
+ * @brief DataDeviceInterface allows clients to share data by copy-and-paste and drag-and-drop.
+ *
+ * The data device is per seat.
+ * Copy-and-paste use the selection functions.
+ *
+ * Represents the Resource for the wl_data_device interface.
  *
  * @see SeatInterface
  * @see DataSourceInterface
diff --git a/src/server/dpms_interface.h b/src/server/dpms_interface.h
--- a/src/server/dpms_interface.h
+++ b/src/server/dpms_interface.h
@@ -33,12 +33,13 @@
 class Display;
 
 /**
- * @brief Global for the org_kde_kwin_dpms_manager interface.
+ * @brief Global for server side Display Power Management Signaling interface.
  *
- * If the DpmsManagerInterface is created it allows a client to
- * query the Dpms state on a given OutputInterface and request
- * changes for it. The code interaction happens only via the
- * OutputInterface.
+ * A DpmsManagerInterface allows a client to query the DPMS state
+ * on a given OutputInterface and request changes to it.
+ * Server-side the interaction happens only via the OutputInterface,
+ * for clients the Dpms class provides the API.
+ * This global implements org_kde_kwin_dpms_manager.
  *
  * To create a DpmsManagerInterface use:
  * @code