diff --git a/yesod/README b/yesod/README
deleted file mode 100644
index f98ab5ec..00000000
--- a/yesod/README
+++ /dev/null
@@ -1,3 +0,0 @@
-After installing, type "yesod init" to start a new project.
-
-Learn more at http://www.yesodweb.com/book
diff --git a/yesod/development.md b/yesod/README.md
similarity index 69%
rename from yesod/development.md
rename to yesod/README.md
index 531621ea..c6ecbe06 100644
--- a/yesod/development.md
+++ b/yesod/README.md
@@ -1,3 +1,13 @@
+# Overview
+
+The yesod package
+* groups together the various Yesod related packages into one cohesive whole.
+* contains the executable yesod
+
+There are 2 main features of the executable
+* yesod devel - star a development environment
+* yesod init - create a scaffolded site
+
 # Scaffolding
 
 ## Test suite