diff --git a/examples/rpl-border-router/embedded/README.md b/examples/rpl-border-router/embedded/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..66ae6c4c8f5851ed76064e1c09e192452116ec27
--- /dev/null
+++ b/examples/rpl-border-router/embedded/README.md
@@ -0,0 +1,5 @@
+This is a border router that runs embedded in a node. The node runs a full
+6LoWPAN stack, and acts as a DAG root. It interfaces to the outside world
+via a serial line. On the host Operating System, `tunslip6` is used to create
+a tun interface and bridge it to the RPL border router. This is achieved with
+makefile targets `connect-router` and `connect-router-cooja`.