Troubleshooting/Docked-mode.md

@@ -12,11 +12,11 @@ For a working connection you need the following things: a [working dock](#Inform
 
 ## background
 
-**todo, work in progress**
+The Librem5 supports **_[DisplayPort Alternate Mode](https://en.wikipedia.org/wiki/DisplayPort#USB-C)_ only** which allows you to connect a monitor to its usb-c port using an appropriate [adapter](#usb-ids-of-your-dockhub).
 
-* https://developer.puri.sm/Librem5/FAQ.html#external-display (hdmi alt mode?! - really? - not: see updated page in repo https://source.puri.sm/Librem5/developer.puri.sm/-/blob/master/FAQ.rst).
-* https://en.wikipedia.org/wiki/DisplayPort#USB-C
-* not supported by default: https://en.wikipedia.org/wiki/DisplayLink. Might work with additional software if it is available for arm64.
+This adapter might convert the DisplayPort signal to HDMI internally to let you use a HDMI connection, but USB-C **_HDMI Alternate Mode_ is not supported**.
+
+The similar sounding technology _[DisplayLink](https://en.wikipedia.org/wiki/DisplayLink)_ is not supported by PureOS nor by any other system running on the Librem5 known at time of writing. It might work with additional software installed.
 
 # cables
 ## usb-c cables