diff --git a/README.md b/README.md
index b8ef878dd..70b1eff68 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,8 @@
 # klayout
-KLayout Main Sources
+
+This repository will hold the main sources for the KLayout project.
+
+Plugins can be included into the "plugins" directory from external sources.
+
+For more details see http://www.klayout.org.
+