doc: doxygen: improve name/desc of Device Drivers group

add an actual meaningful brief and detailed desc

Signed-off-by: Benjamin Cabé <[email protected]>

Author: kartben

doc/_doxygen/groups.dox

@@ -11,14 +11,16 @@
 @{
 @}
 
-@brief Device Driver APIs
-@defgroup io_interfaces Device Driver APIs
+@defgroup io_interfaces Device Drivers
+@brief Interfaces to interact with various hardware peripherals.
+@details A collection of hardware-agnostic interfaces used to implement and interact with device
+         drivers.
 @{
 @}
 
-@brief Miscellaneous Drivers APIs
-@defgroup misc_interfaces Miscellaneous Drivers APIs
+@defgroup misc_interfaces Miscellaneous Devices
 @ingroup io_interfaces
+@brief Interfaces for hardware peripherals that do not have a dedicated driver class.
 @{
 @}
 
@@ -28,8 +30,8 @@
 @{
 @}
 
-@brief Multi Function Device Drivers APIs
-@defgroup mfd_interfaces Multi Function Device Drivers APIs
+@brief Interfaces for multi-function devices.
+@defgroup mfd_interfaces Multi-function Devices
 @ingroup io_interfaces
 @{
 @}

include/zephyr/drivers/pcie/controller.h

@@ -21,9 +21,9 @@
 #endif
 
 /**
- * @brief PCI Express Controller Interface
- * @defgroup pcie_controller_interface PCI Express Controller Interface
- * @ingroup io_interfaces
+ * @brief Interfaces for PCIe Controllers.
+ * @defgroup pcie_controller_interface PCIe Controller
+ * @ingroup pcie_interface
  * @{
  */
 

include/zephyr/drivers/pcie/pcie.h

@@ -8,10 +8,16 @@
 #define ZEPHYR_INCLUDE_DRIVERS_PCIE_PCIE_H_
 
 /**
- * @brief PCIe Host Interface
- * @defgroup pcie_host_interface PCIe Host Interface
+ * @brief Interfaces for PCIe devices.
+ * @defgroup pcie_interface PCIe
  * @ingroup io_interfaces
  * @{
+ * @}
+ *
+ * @brief Interfaces for PCIe Host.
+ * @defgroup pcie_host_interface PCIe Host
+ * @ingroup pcie_interface
+ * @{
  */
 
 #include <stddef.h>