diff --git a/examples/qtquick/dockwidgets/main.cpp b/examples/qtquick/dockwidgets/main.cpp
index 454837f1..b21ea903 100644
--- a/examples/qtquick/dockwidgets/main.cpp
+++ b/examples/qtquick/dockwidgets/main.cpp
@@ -69,15 +69,21 @@ int main(int argc, char *argv[])
         internalFlags |= KDDockWidgets::Config::InternalFlag_NoAeroSnap;
 # endif
 
+    // These are debug-only/development flags, which you can ignore.
     KDDockWidgets::Config::self().setInternalFlags(internalFlags);
 #endif
 
+    // Set any required flags. The defaults are usually fine.
     KDDockWidgets::Config::self().setFlags(flags);
 
+    // Create your engine which loads main.qml. A simple QQuickView would work too.
     QQmlApplicationEngine appEngine;
     KDDockWidgets::Config::self().setQmlEngine(&appEngine);
     appEngine.load((QUrl("qrc:/main.qml")));
 
+    // Bellow we illustrate usage of our C++ API. Alternative you can use declarative API.
+    // See main.qml for examples of dockwidgets created directly in QML
+
     auto dw1 = new KDDockWidgets::DockWidgetQuick("Dock #1");
 
     dw1->setWidget(QStringLiteral("qrc:/Guest1.qml"));