Add info about dev vs. prod builds

sophiebits · zpao · commit 92102ac31d57 · 2014-01-15T11:35:51.000-08:00
Also moved the dev builds first because that's what most people will want.
diff --git a/docs/downloads.md b/docs/downloads.md
@@ -4,52 +4,58 @@ title: Downloads
 layout: single
 ---
 Download the starter kit to get everything you need to
-[get started with React](/react/docs/getting-started.html).
+[get started with React](/react/docs/getting-started.html). The starter kit includes React, the in-browser JSX transformer, and some simple example apps.
 
 <div class="buttons-unit downloads">
   <a href="/react/downloads/react-{{site.react_version}}.zip" class="button">
     Download Starter Kit {{site.react_version}}
   </a>
 </div>
 
-## Individual Downloads
+## Development vs. Production Builds
 
-#### <a href="http://fb.me/react-{{site.react_version}}.min.js">React Core {{site.react_version}} (production)</a>
-The compressed, production version of React core
+We provide two versions of React: an uncompressed version for development and a minified version for production. The development version includes extra warnings about common mistakes, whereas the production version includes extra performance optimizations and strips all error messages.
 
-```html
-<script src="http://fb.me/react-{{site.react_version}}.min.js"></script>
-```
+If you're just starting out, make sure to use the development version.
 
-#### <a href="http://fb.me/react-{{site.react_version}}.js">React Core {{site.react_version}} (development)</a>
+## Individual Downloads
+
+#### <a href="http://fb.me/react-{{site.react_version}}.js">React {{site.react_version}} (development)</a>
 The uncompressed, development version of React core with inline documentation.
 
 ```html
 <script src="http://fb.me/react-{{site.react_version}}.js"></script>
 ```
 
-#### <a href="http://fb.me/react-with-addons-{{site.react_version}}.min.js">React With Add-Ons {{site.react_version}} (production)</a>
-The compressed, production version of React with [add-ons](/react/docs/addons.html).
+#### <a href="http://fb.me/react-{{site.react_version}}.min.js">React {{site.react_version}} (production)</a>
+The compressed, production version of React core.
 
 ```html
-<script src="http://fb.me/react-with-addons-{{site.react_version}}.min.js"></script>
+<script src="http://fb.me/react-{{site.react_version}}.min.js"></script>
 ```
 
-#### <a href="http://fb.me/react-with-addons-{{site.react_version}}.js">React With Add-Ons {{site.react_version}} (development)</a>
+#### <a href="http://fb.me/react-with-addons-{{site.react_version}}.js">React with Add-Ons {{site.react_version}} (development)</a>
 The uncompressed, development version of React with [add-ons](/react/docs/addons.html).
 
 ```html
 <script src="http://fb.me/react-with-addons-{{site.react_version}}.js"></script>
 ```
 
-#### <a href="http://fb.me/JSXTransformer-{{site.react_version}}.js">JSX Transform</a>
+#### <a href="http://fb.me/react-with-addons-{{site.react_version}}.min.js">React with Add-Ons {{site.react_version}} (production)</a>
+The compressed, production version of React with [add-ons](/react/docs/addons.html).
+
+```html
+<script src="http://fb.me/react-with-addons-{{site.react_version}}.min.js"></script>
+```
+
+#### <a href="http://fb.me/JSXTransformer-{{site.react_version}}.js">JSX Transformer</a>
 The JSX transformer used to support [XML syntax](/react/docs/jsx-in-depth.html) in JavaScript.
 
 ```html
 <script src="http://fb.me/JSXTransformer-{{site.react_version}}.js"></script>
 ```
 
-All scripts are also available via [CDNJS](http://cdnjs.com/#react).
+All scripts are also available via [CDNJS](http://cdnjs.com/libraries/react/).
 
 ## Bower
 
