diff --git a/kubernetes/README.md b/kubernetes/README.md
new file mode 100644
index 0000000000..96f78d9328
--- /dev/null
+++ b/kubernetes/README.md
@@ -0,0 +1,5 @@
+# Kubernetes client libraries
+
+This package (and sub-packages) holds the client libraries for the kubernetes integration in
+the docker platform. Most of the code is currently generated but will evolved quickly in
+the next months.
\ No newline at end of file