diff --git a/boards/nrf52840dk/doc.txt b/boards/nrf52840dk/doc.txt
index 3129f874825be4b941e84367f9a692bfc093297b..29e51439bb02f18e62451d8041aaf793eac3a7c3 100644
--- a/boards/nrf52840dk/doc.txt
+++ b/boards/nrf52840dk/doc.txt
@@ -13,4 +13,33 @@ this, RIOT provides a little tool in `dist/tools/nrf52_resetpin_cfg`.
 Simply compile, flash, and run that tool on your board, and the reset pin should
 work for the time being.
 
+## Flash the board
+
+By default, the board is flashed with via the on-board Segger JLink adapter.
+
+To flash the board, use `BOARD=nrf52840dk` with the `make` command.<br/>
+Example with `hello-world` application:
+```
+    make BOARD=nrf52840dk -C examples/hello-world flash
+```
+
+OpenOCD can also be used. For the moment, the latest stable version of OpenOCD
+(0.10) doesn't contain any support for nrf52 but versions built against the
+actual development version can be used.
+
+To flash the board with OpenOCD, use the `PROGRAMMER` variable:
+```
+    PROGRAMMER=openocd make BOARD=nrf52840dk -C examples/hello-world flash
+```
+
+## Accessing STDIO via UART
+
+The STDIO is directly accessible via the USB port. On a Linux host, it's
+generally mapped to `/dev/ttyACM0`.
+
+Use the `term` target to connect to the board serial port<br/>
+```
+    make BOARD=nrf52840dk -C examples/hello-world term
+```
+
  */
diff --git a/boards/nrf52dk/doc.txt b/boards/nrf52dk/doc.txt
index b32c08d7e5e48e587b799ab362273d960bf12077..4e42d210948614e1825f101cdb1b0e3588ccd0a3 100644
--- a/boards/nrf52dk/doc.txt
+++ b/boards/nrf52dk/doc.txt
@@ -104,4 +104,34 @@ work for the time being.
 There are two pins for current measurement on board. Don't connect these pins
 to GND!. The left pin is at 3.3V level and the right pin is connected to V33.
 Divide the measured voltage between this pins by 22 to get the current.
+
+
+## Flash the board
+
+By default, the board is flashed with via the on-board Segger JLink adapter.
+
+To flash the board, use `BOARD=nrf52dk` with the `make` command.<br/>
+Example with `hello-world` application:
+```
+    make BOARD=nrf52dk -C examples/hello-world flash
+```
+
+OpenOCD can also be used. For the moment, the latest stable version of OpenOCD
+(0.10) doesn't contain any support for nrf52 but versions built against the
+actual development version can be used.
+
+To flash the board with OpenOCD, use the `PROGRAMMER` variable:
+```
+    PROGRAMMER=openocd make BOARD=nrf52dk -C examples/hello-world flash
+```
+
+## Accessing STDIO via UART
+
+The STDIO is directly accessible via the USB port. On a Linux host, it's
+generally mapped to `/dev/ttyACM0`.
+
+Use the `term` target to connect to the board serial port<br/>
+```
+    make BOARD=nrf52dk -C examples/hello-world term
+```
  */