diff --git a/eclipse-distribution/README.md b/eclipse-distribution/README.md
new file mode 100644
index 000000000..8420ec6dc
--- /dev/null
+++ b/eclipse-distribution/README.md
@@ -0,0 +1,3 @@
+# eclipse distribution
+STS 4 provides a ready to use distribution of Eclipse, equipped with all the necessary extensions and plugins that are useful to develop Spring Boot apps.
+The necessary product and build definitions are included here.
diff --git a/eclipse-extensions/README.md b/eclipse-extensions/README.md
new file mode 100644
index 000000000..443926fef
--- /dev/null
+++ b/eclipse-extensions/README.md
@@ -0,0 +1,3 @@
+# eclipse extensions
+STS 4 provides a set of extensions to the Eclipse IDE. Those Eclipse plugin projects are hosted here.
+
diff --git a/headless-services/README.md b/headless-services/README.md
new file mode 100644
index 000000000..3521adfd1
--- /dev/null
+++ b/headless-services/README.md
@@ -0,0 +1,2 @@
+# headless services
+The main parts of the tooling for Spring Boot apps are implemented as headless services, running in separate processes. Those services can be consumed in existing IDEs by using the Language Server Protocol from Visual Studio Code.
diff --git a/vscode-extensions/README.md b/vscode-extensions/README.md
new file mode 100644
index 000000000..6682b5ca0
--- /dev/null
+++ b/vscode-extensions/README.md
@@ -0,0 +1,3 @@
+# vscode extensions
+STS 4 provides a set of extensions to the Visual Studio Code editor. Those extension projects are hosted here.
+