diff --git a/boards/common/arduino-mkr/board.c b/boards/common/arduino-mkr/board.c
index 939d06ced8..c78e883681 100644
--- a/boards/common/arduino-mkr/board.c
+++ b/boards/common/arduino-mkr/board.c
@@ -9,12 +9,13 @@
 
 /**
  * @ingroup     boards_arduino-mkr-common
- *
+ * @{
  * @file
  * @brief       Board common implementations for the Arduino MKR boards
  *
- *  @author      Hauke Pertersen  <hauke.pertersen@fu-berlin.de>
+ * @author      Hauke Pertersen  <hauke.pertersen@fu-berlin.de>
  * @author      Alexandre Abadie <alexandre.abadie@inria.fr>
+ *
  * @}
  */
 
diff --git a/boards/common/arduino-mkr/include/arduino_board.h b/boards/common/arduino-mkr/include/arduino_board.h
index 41c8fc8796..4346e45194 100644
--- a/boards/common/arduino-mkr/include/arduino_board.h
+++ b/boards/common/arduino-mkr/include/arduino_board.h
@@ -8,7 +8,7 @@
  */
 
 /**
- * @ingroup     boards_arduino-mkr1000
+ * @ingroup     boards_common_arduino-mkr
  * @{
  *
  * @file
diff --git a/boards/common/arduino-mkr/include/arduino_pinmap.h b/boards/common/arduino-mkr/include/arduino_pinmap.h
index b48a11f886..2c53522568 100644
--- a/boards/common/arduino-mkr/include/arduino_pinmap.h
+++ b/boards/common/arduino-mkr/include/arduino_pinmap.h
@@ -7,7 +7,7 @@
  */
 
 /**
- * @ingroup     boards_arduino-mkr-common
+ * @ingroup     boards_common_arduino-mkr
  * @{
  *
  * @file
diff --git a/boards/common/arduino-mkr/include/board_common.h b/boards/common/arduino-mkr/include/board_common.h
index 7208e0fdef..459a5f8898 100644
--- a/boards/common/arduino-mkr/include/board_common.h
+++ b/boards/common/arduino-mkr/include/board_common.h
@@ -7,9 +7,9 @@
  */
 
 /**
- * @defgroup    boards_arduino-mkr-common Arduino MKR Common
- * @ingroup     boards
- * @brief       Support for the Arduino MKR boards type.
+ * @defgroup    boards_common_arduino-mkr Arduino MKR Common
+ * @ingroup     boards_common
+ * @brief       Shared files and configuration for the Arduino MKR boards type.
  * @{
  *
  * @file
diff --git a/boards/common/arduino-mkr/include/gpio_params.h b/boards/common/arduino-mkr/include/gpio_params.h
index 9d573ee9ea..df0e4c9af8 100644
--- a/boards/common/arduino-mkr/include/gpio_params.h
+++ b/boards/common/arduino-mkr/include/gpio_params.h
@@ -8,14 +8,14 @@
  */
 
 /**
- * @ingroup   boards_arduino-mkr-common
+ * @ingroup     boards_common_arduino-mkr
  * @{
  *
  * @file
- * @brief     Board specific configuration of direct mapped GPIOs
+ * @brief       Board specific configuration of direct mapped GPIOs
  *
- * @author    Alexandre Abadie <alexandre.abadie@inria.fr>
- * @author    Hauke Petersen <hauke.petersen@fu-berlin.de>
+ * @author      Alexandre Abadie <alexandre.abadie@inria.fr>
+ * @author      Hauke Petersen <hauke.petersen@fu-berlin.de>
  */
 
 #ifndef GPIO_PARAMS_H
diff --git a/boards/common/arduino-mkr/include/periph_conf.h b/boards/common/arduino-mkr/include/periph_conf.h
index b13064bc45..f439b1f1b9 100644
--- a/boards/common/arduino-mkr/include/periph_conf.h
+++ b/boards/common/arduino-mkr/include/periph_conf.h
@@ -8,7 +8,7 @@
  */
 
 /**
- * @ingroup     boards_arduino-mkr-common
+ * @ingroup     boards_common_arduino-mkr
  * @{
  *
  * @file