Add info about dev vs. prod builds
Also moved the dev builds first because that's what most people will want.
Ben Alpert committed
Dec 31, 2013 at 10:35 UTC
c877451887d1fc531e7c2637681f47cf50d6a5de
1 file changed
+20
-14
docs/downloads.md
+20
-14
@@ -4,7 +4,7 @@ title: Downloads
4
layout: single
5
---
6
Download the starter kit to get everything you need to
7
-[get started with React](/react/docs/getting-started.html).
7
+[get started with React](/react/docs/getting-started.html). The starter kit includes React, the in-browser JSX transformer, and some simple example apps.
8
9
<div class="buttons-unit downloads">
10
<a href="/react/downloads/react-{{site.react_version}}.zip" class="button">
@@ -12,44 +12,50 @@ Download the starter kit to get everything you need to
12
</a>
13
</div>
14
15
-## Individual Downloads
15
+## Development vs. Production Builds
16
17
-#### <a href="http://fb.me/react-{{site.react_version}}.min.js">React Core {{site.react_version}} (production)</a>
18
-The compressed, production version of React core
17
+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.
18
20
-```html
21
-<script src="http://fb.me/react-{{site.react_version}}.min.js"></script>
22
-```
19
+If you're just starting out, make sure to use the development version.
20
24
-#### <a href="http://fb.me/react-{{site.react_version}}.js">React Core {{site.react_version}} (development)</a>
21
+## Individual Downloads
22
+
23
+#### <a href="http://fb.me/react-{{site.react_version}}.js">React {{site.react_version}} (development)</a>
24
The uncompressed, development version of React core with inline documentation.
25
26
```html
27
<script src="http://fb.me/react-{{site.react_version}}.js"></script>
28
```
29
31
-#### <a href="http://fb.me/react-with-addons-{{site.react_version}}.min.js">React With Add-Ons {{site.react_version}} (production)</a>
32
-The compressed, production version of React with [add-ons](/react/docs/addons.html).
30
+#### <a href="http://fb.me/react-{{site.react_version}}.min.js">React {{site.react_version}} (production)</a>
31
+The compressed, production version of React core.
32
33
```html
35
-<script src="http://fb.me/react-with-addons-{{site.react_version}}.min.js"></script>
34
+<script src="http://fb.me/react-{{site.react_version}}.min.js"></script>
35
```
36
38
-#### <a href="http://fb.me/react-with-addons-{{site.react_version}}.js">React With Add-Ons {{site.react_version}} (development)</a>
37
+#### <a href="http://fb.me/react-with-addons-{{site.react_version}}.js">React with Add-Ons {{site.react_version}} (development)</a>
38
The uncompressed, development version of React with [add-ons](/react/docs/addons.html).
39
40
```html
41
<script src="http://fb.me/react-with-addons-{{site.react_version}}.js"></script>
42
```
43
45
-#### <a href="http://fb.me/JSXTransformer-{{site.react_version}}.js">JSX Transform</a>
44
+#### <a href="http://fb.me/react-with-addons-{{site.react_version}}.min.js">React with Add-Ons {{site.react_version}} (production)</a>
45
+The compressed, production version of React with [add-ons](/react/docs/addons.html).
46
+
47
+```html
48
+<script src="http://fb.me/react-with-addons-{{site.react_version}}.min.js"></script>
49
+```
50
+
51
+#### <a href="http://fb.me/JSXTransformer-{{site.react_version}}.js">JSX Transformer</a>
52
The JSX transformer used to support [XML syntax](/react/docs/jsx-in-depth.html) in JavaScript.
53
54
```html
55
<script src="http://fb.me/JSXTransformer-{{site.react_version}}.js"></script>
56
```
57
52
-All scripts are also available via [CDNJS](http://cdnjs.com/#react).
58
+All scripts are also available via [CDNJS](http://cdnjs.com/libraries/react/).
59
60
## Bower
61