diff --git a/src/declarativeimports/plasmacomponents/README.md b/src/declarativeimports/plasmacomponents/README.md
new file mode 100644
--- /dev/null
+++ b/src/declarativeimports/plasmacomponents/README.md
@@ -0,0 +1,5 @@
+Plasma Components 2 is a style for QtQuick Controls 1.
+
+As QtQuick Controls 1 is not going to be part of Qt6, this folder should be considered feature frozen with no new behavioural changes or new API.
+
+Use of components in this module in client code is still allowed, as not all features are identical to their QtQuickControls2 counterparts.
diff --git a/src/declarativeimports/plasmacomponents3/README.md b/src/declarativeimports/plasmacomponents3/README.md
new file mode 100644
--- /dev/null
+++ b/src/declarativeimports/plasmacomponents3/README.md
@@ -0,0 +1,7 @@
+Plasma Components 3 is a style for QtQuick Controls 2.
+
+It is exported as an import so users can force a theme, but it is also available just as a style.
+
+This folder should only contain inherited templates from QQC2 desktop themes. There should be no new Components or properties.
+
+New API should be in either upstream QQC2 itself, PlasmaExtras, or Kirigami.