diff --git a/README.md b/README.md
index 09e6760fba40d3a33c228e5676e4f0b89e0904ff..48a893f3cb2a1bf353a6c51bf0beb164a38ac92c 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,8 @@
 # CodeMirror 2
 
-CodeMirror 2 is a rewrite of [CodeMirror
-1](http://github.com/marijnh/CodeMirror). The docs live
-[here](http://codemirror.net/doc/manual.html), and the project page is
-[http://codemirror.net/](http://codemirror.net/).
+CodeMirror is a JavaScript component that provides a code editor in
+the browser. When a mode is available for the language you are coding
+in, it will color your code, and optionally help with indentation.
+
+The project page is http://codemirror.net
+The manual is at http://codemirror.net/doc/manual.html