diff --git a/common/include/villas/kernel/devices/device.hpp b/common/include/villas/kernel/devices/device.hpp
index 18b914585..896cab042 100644
--- a/common/include/villas/kernel/devices/device.hpp
+++ b/common/include/villas/kernel/devices/device.hpp
@@ -1,4 +1,4 @@
-/* Interface for Linux/Unix device drivers
+/* Interface for Linux/Unix devices.
  *
  * Author: Pascal Bauer <pascal.bauer@rwth-aachen.de>
  *
diff --git a/common/include/villas/kernel/devices/driver.hpp b/common/include/villas/kernel/devices/driver.hpp
index 8c58bb726..9f0a023a9 100644
--- a/common/include/villas/kernel/devices/driver.hpp
+++ b/common/include/villas/kernel/devices/driver.hpp
@@ -1,4 +1,4 @@
-/* Driver
+/* Interface for Linux/Unix device drivers
  *
  * Author: Pascal Bauer <pascal.bauer@rwth-aachen.de>
  *
diff --git a/common/include/villas/kernel/devices/ip_device.hpp b/common/include/villas/kernel/devices/ip_device.hpp
index b992e7fb5..14aca5314 100644
--- a/common/include/villas/kernel/devices/ip_device.hpp
+++ b/common/include/villas/kernel/devices/ip_device.hpp
@@ -1,4 +1,4 @@
-/* IpDevice
+/* IpDevice: Linux/Unix device which represents an IP component of a fpga
  *
  * Author: Pascal Bauer <pascal.bauer@rwth-aachen.de>
  *
@@ -22,7 +22,7 @@ public:
 
 private:
   IpDevice() = delete;
-  IpDevice(const std::filesystem::path valid_path)
+  IpDevice(const std::filesystem::path valid_path) //! Dont allow unvalidated paths
       : PlatformDevice(valid_path){};
 
 public:
diff --git a/common/include/villas/kernel/devices/platform_device.hpp b/common/include/villas/kernel/devices/platform_device.hpp
index 4cef2ceb4..a2018b4a4 100644
--- a/common/include/villas/kernel/devices/platform_device.hpp
+++ b/common/include/villas/kernel/devices/platform_device.hpp
@@ -1,4 +1,4 @@
-/* Platform Device
+/* Platform Device: Platform bus based Linux/Unix device.
  *
  * Author: Pascal Bauer <pascal.bauer@rwth-aachen.de>
  *