diff --git a/pkg/openthread/doc.txt b/pkg/openthread/doc.txt
index 4c04a6737a..bc35d7f961 100644
--- a/pkg/openthread/doc.txt
+++ b/pkg/openthread/doc.txt
@@ -4,7 +4,8 @@
  * @ingroup  net
  * @brief    Provides a RIOT adaption of the OpenThread network stack
  * @see      https://github.com/openthread/openthread
- * @note     Currently there's only support for @ref drivers_at86rf2xx.
- *           There's a work in progress to support more radio drivers
- *           (see [this issue](https://github.com/RIOT-OS/RIOT/issues/10045))
+ * @note     A good technical introduction to how Thread works is available in
+ *           the [thread primer] of OpenThread.
+ *
+ * [thread primer]: https://openthread.io/guides/thread-primer
  */
diff --git a/sys/net/ieee802154.txt b/sys/net/ieee802154.txt
index 930e61c532..b9c58031b1 100644
--- a/sys/net/ieee802154.txt
+++ b/sys/net/ieee802154.txt
@@ -66,9 +66,11 @@
  * protocols used on top of it, applications always need to pick their
  * components; that selection is often guided by standards or organizations
  * that pick an interoperable set of components (higher-level protocol, MAC,
- * band and others), like Thread (6LoWPAN, nonbeacon-enabled, 2.4GHz),
+ * band and others), like [Thread] \(6LoWPAN, nonbeacon-enabled, 2.4GHz),
  * WirelessHART (HART, TSCH, 2.4GHz) or 6TiSCH (6LoWPAN, TSCH).
  *
+ * [Thread]: https://openthread.io/guides/thread-primer
+ *
  * Availability in RIOT
  * --------------------
  *