diff --git a/mqttclient/README.md b/mqttclient/README.md
new file mode 100644
index 00000000..adf49fe8
--- /dev/null
+++ b/mqttclient/README.md
@@ -0,0 +1,16 @@
+# MQTT client
+
+This plugin allows to subscribe and publish to MQTT brokers (the nymea internal broker and external ones).
+
+> This plugin is ment to be combined with a rule.
+
+
+## Example
+
+A device is configured to publish its state to a MQTT broker. Using this plugin the user can subscribe to
+the same topic on that broker and monitor the device's state.
+
+Publishing is also supported. This allows use cases such as controlling IoT things via MQTT by publishing
+to topics such devices are subscribed to. Other possibilities are to use nymea as a "translator" between other
+transport layers to MQTT. For instance a sensor might deliver sensor data via Bluetooth to Nymea and using this
+MQTT plugin and a rule nymea can be configured to forward all those sensor values to a MQTT broker.
diff --git a/mqttclient/devicepluginmqttclient.cpp b/mqttclient/devicepluginmqttclient.cpp
index 5d99a6ea..8ab193f9 100644
--- a/mqttclient/devicepluginmqttclient.cpp
+++ b/mqttclient/devicepluginmqttclient.cpp
@@ -20,37 +20,6 @@
  *                                                                         *
  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 
-/*!
-    \page mqtt.html
-    \title Generic MQTT
-    \brief Plugin for subscribing and publishing to an MQTT broker.
-
-    \ingroup plugins
-    \ingroup nymea-plugins-maker
-
-    This plugin allows to subscribe and publish to MQTT brokers (the nymea internal broker and external ones).
-
-    \note This plugin is ment to be combined with a \l{nymeaserver::Rule}.
-
-    \section3 Example
-
-    A device is configured to publish its state to a MQTT broker. Using this plugin the user can subscribe to
-    the same topic on that broker and monitor the device's state.
-
-    Publishing is also supported. This allows use cases such as controlling IoT things via MQTT by publishing
-    to topics such devices are subscribed to. Other possibilities are to use nymea as a "translator" between other
-    transport layers to MQTT. For instance a sensor might deliver sensor data via Bluetooth to Nymea and using this
-    MQTT plugin and a \l{nymeaserver::Rule} nymea can be configured to forward all those sensor values to a MQTT broker.
-
-    \chapter Plugin properties
-    The plugin implements the inputtrigger and outputtrigger interfaces, adding parameters for topic and payload to
-    the trigger action and triggered event.
-
-    For more details how to read this JSON file please check out the documentation for \l{The plugin JSON File}.
-
-    \quotefile plugins/deviceplugins/mqtt/devicepluginmqttclient.json
-*/
-
 #include "devicepluginmqttclient.h"
 #include "plugin/device.h"
 #include "plugininfo.h"