diff --git a/boards/olimex-msp430-h1611/doc.txt b/boards/olimex-msp430-h1611/doc.txt
index a19e1873a5..4d2d368734 100644
--- a/boards/olimex-msp430-h1611/doc.txt
+++ b/boards/olimex-msp430-h1611/doc.txt
@@ -66,9 +66,9 @@ among the less expensive options.
 @warning    A jumper in `P_OUT` is mutually exclusive to a jumper in `P_IN`.
             Never connect both at the same time.
 
-@note       While the JTAG connector has no markings, you can easily spot pin 1
-            on to bottom of the board by the square pad; all other JTAG pins
-            have a circular pad.
+@note       Pin 1 on the JTAG connector has a small white triangle next to it
+            and square pad, compared to the round pad used by all other JTAG
+            pins.
 
 Once the jumper is correctly placed in either `P_IN` or in `P_OUT` and the
 JTAG cable is connected just run
diff --git a/drivers/include/mrf24j40.h b/drivers/include/mrf24j40.h
index 87ab8d335f..613ef38cc3 100644
--- a/drivers/include/mrf24j40.h
+++ b/drivers/include/mrf24j40.h
@@ -14,6 +14,13 @@
  * This module contains drivers for radio devices in Microchip MRF24J40 series.
  * The driver is aimed to work with all devices of this series.
  *
+ * @warning     This driver doesn't handle the wake pin. As of now, it is
+ *              required that the wake pin is high prior to the initialization
+ *              (e.g. by connecting it to VCC in the board design).
+ * @note        A PR extending @ref mrf24j40_params_t to contain the wake pin
+ *              and adding appropriate handling of the wake pin to the driver
+ *              logic would be a welcome addition.
+ *
  * Default TX power is 0dBm.
  *
  * TX power mapping: