diff --git a/README.md b/README.md
index c53ce57c7..1210e1b53 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,11 @@
-# codalab
+# CodaLab
 
 This is CodaLab. It goes to eleven. Just not yet.
 
+## What is it?
+
+Take a look at the [developing specification](docs/SPECIFICATION.md).
+
 ## Local Installation
 
 This is all Python.  It works on Windows, Linux, Mac and BSD most of the time.
diff --git a/SPECIFICATION.md b/docs/SPECIFICATION.md
similarity index 100%
rename from SPECIFICATION.md
rename to docs/SPECIFICATION.md