diff --git a/.travis.yml b/.travis.yml index 8ecb5b8661..e2a9f72e12 100644 --- a/.travis.yml +++ b/.travis.yml @@ -1,8 +1,11 @@ --- +sudo: required +dist: trusty language: node_js node_js: - 4 -sudo: false +rvm: +- 2.2.3 cache: directories: - docs/vendor/bundle diff --git a/CHANGELOG.md b/CHANGELOG.md index d92bedab35..75c1ed8b37 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,34 @@ +## 15.3.0 (July 29, 2016) + +### React +- Add `React.PureComponent` - a new base class to extend, replacing `react-addons-pure-render-mixin` now that mixins don't work with ES2015 classes. ([@spicyj](https://github.com/spicyj) in [#7195](https://github.com/facebook/react/pull/7195)) +- Add new warning when modifying `this.props.children`. ([@jimfb](https://github.com/jimfb) in [#7001](https://github.com/facebook/react/pull/7001)) +- Fixed issue with ref resolution order. ([@gaearon](https://github.com/gaearon) in [#7101](https://github.com/facebook/react/pull/7101)) +- Warn when mixin is undefined. ([@swaroopsm](https://github.com/swaroopsm) in [#6158](https://github.com/facebook/react/pull/6158)) +- Downgrade "unexpected batch number" invariant to a warning. ([@spicyj](https://github.com/spicyj) in [#7133](https://github.com/facebook/react/pull/7133)) +- Validate arguments to `oneOf` and `oneOfType` PropTypes sooner. ([@troydemonbreun](https://github.com/troydemonbreun) in [#6316](https://github.com/facebook/react/pull/6316)) +- Warn when calling PropTypes directly. ([@Aweary](https://github.com/Aweary) in [#7132](https://github.com/facebook/react/pull/7132), [#7194](https://github.com/facebook/react/pull/7194)) +- Improve warning when using Maps as children. ([@keyanzhang](https://github.com/keyanzhang) in [#7260](https://github.com/facebook/react/pull/7260)) +- Add additional type information to the `PropTypes.element` warning. ([@alexzherdev](https://github.com/alexzherdev) in [#7319](https://github.com/facebook/react/pull/7319)) +- Improve component identification in no-op `setState` warning. ([@keyanzhang](https://github.com/keyanzhang) in [#7326](https://github.com/facebook/react/pull/7326)) + +### React DOM +- Fix issue with nested server rendering. ([@Aweary](https://github.com/Aweary) in [#7033](https://github.com/facebook/react/pull/7033)) +- Add `xmlns`, `xmlnsXlink` to supported SVG attributes. ([@salzhrani](https://github.com/salzhrani) in [#6471](https://github.com/facebook/react/pull/6471)) +- Add `referrerPolicy` to supported HTML attributes. ([@Aweary](https://github.com/Aweary) in [#7274](https://github.com/facebook/react/pull/7274)) +- Fix issue resulting in `` initial value being rounded. ([@troydemonbreun](https://github.com/troydemonbreun) in [#7251](https://github.com/facebook/react/pull/7251)) + +### React Test Renderer +- Initial public release of package allowing more focused testing. Install with `npm install react-test-renderer`. ([@spicyj](https://github.com/spicyj) in [#6944](https://github.com/facebook/react/pull/6944), [#7258](https://github.com/facebook/react/pull/7258), [@iamdustan](https://github.com/iamdustan) in [#7362](https://github.com/facebook/react/pull/7362)) + +### React Perf Add-on +- Fix issue resulting in excessive warnings when encountering an internal measurement error. ([@sassanh](https://github.com/sassanh) in [#7299](https://github.com/facebook/react/pull/7299)) + +### React TestUtils Add-on +- Implement `type` property on for events created via `TestUtils.Simulate.*`. ([@yaycmyk](https://github.com/yaycmyk) in [#6154](https://github.com/facebook/react/pull/6154)) +- Fix crash when running TestUtils with the production build of React. ([@gaearon](https://github.com/gaearon) in [#7246](https://github.com/facebook/react/pull/7246)) + + ## 15.2.1 (July 8, 2016) ### React diff --git a/README.md b/README.md index e26c89bfe6..6d618ff784 100644 --- a/README.md +++ b/README.md @@ -31,16 +31,16 @@ You'll notice that we used an HTML-like syntax; [we call it JSX](https://faceboo ## Installation -The fastest way to get started is to serve JavaScript from the CDN (also available on [cdnjs](https://cdnjs.com/libraries/react) and [jsdelivr](https://www.jsdelivr.com/projects/react)): +The fastest way to get started is to serve JavaScript from a CDN. We're using [npmcdn](https://npmcdn.com/) below but React is also available on [cdnjs](https://cdnjs.com/libraries/react) and [jsdelivr](https://www.jsdelivr.com/projects/react): ```html - + - + ``` -We've also built a [starter kit](https://facebook.github.io/react/downloads/react-15.2.1.zip) which might be useful if this is your first time using React. It includes a webpage with an example of using React with live code. +We've also built a [starter kit](https://facebook.github.io/react/downloads/react-15.3.0.zip) which might be useful if this is your first time using React. It includes a webpage with an example of using React with live code. If you'd like to use [bower](http://bower.io), it's as easy as: diff --git a/docs/404.md b/docs/404.md index 6d4039fb3d..ab9ba1d60c 100644 --- a/docs/404.md +++ b/docs/404.md @@ -1,6 +1,7 @@ --- layout: single title: Page Not Found +permalink: 404.html --- We couldn't find what you were looking for. diff --git a/docs/Gemfile b/docs/Gemfile index 4f4991e3b2..f144584eff 100644 --- a/docs/Gemfile +++ b/docs/Gemfile @@ -3,11 +3,12 @@ source 'https://rubygems.org' gem 'rake' # jekyll, which builds it all -# 2.0 includes sass processing -gem 'jekyll', '~>2.0' +# 3.0 includes sass processing +gem 'jekyll', '~>3.1' -# Auto redirect pages +# Jekyll extensions gem 'jekyll-redirect-from' +gem 'jekyll-paginate' # JSON gem 'json' @@ -17,3 +18,12 @@ gem 'rb-fsevent' # For markdown header cleanup gem 'sanitize', '~>2.0' + +# Markdown +gem 'redcarpet' + +# Syntax highlighting +gem 'pygments.rb' + +# Avoid having to poll for changes on Windows +gem 'wdm', '>= 0.1.0' if Gem.win_platform? \ No newline at end of file diff --git a/docs/Gemfile.lock b/docs/Gemfile.lock index 89a0f264aa..bd77546562 100644 --- a/docs/Gemfile.lock +++ b/docs/Gemfile.lock @@ -1,85 +1,70 @@ GEM remote: https://rubygems.org/ specs: - blankslate (2.1.2.4) - celluloid (0.15.2) - timers (~> 1.1.0) - classifier (1.3.4) - fast-stemmer (>= 1.0.0) - coffee-script (2.3.0) - coffee-script-source - execjs - coffee-script-source (1.7.1) colorator (0.1) - execjs (2.2.1) - fast-stemmer (1.0.2) - ffi (1.9.3) - jekyll (2.2.0) - classifier (~> 1.3) + ffi (1.9.14) + ffi (1.9.14-x64-mingw32) + jekyll (3.1.6) colorator (~> 0.1) - jekyll-coffeescript (~> 1.0) - jekyll-gist (~> 1.0) - jekyll-paginate (~> 1.0) jekyll-sass-converter (~> 1.0) - jekyll-watch (~> 1.0) + jekyll-watch (~> 1.1) kramdown (~> 1.3) - liquid (~> 2.6.1) + liquid (~> 3.0) mercenary (~> 0.3.3) - pygments.rb (~> 0.6.0) - redcarpet (~> 3.1) + rouge (~> 1.7) safe_yaml (~> 1.0) - toml (~> 0.1.0) - jekyll-coffeescript (1.0.0) - coffee-script (~> 2.2) - jekyll-gist (1.1.0) - jekyll-paginate (1.0.0) - jekyll-redirect-from (0.5.0) - jekyll (~> 2.0) - jekyll-sass-converter (1.2.0) - sass (~> 3.2) - jekyll-watch (1.1.0) - listen (~> 2.7) - json (1.8.1) - kramdown (1.4.1) - liquid (2.6.1) - listen (2.7.9) - celluloid (>= 0.15.2) - rb-fsevent (>= 0.9.3) - rb-inotify (>= 0.9) - mercenary (0.3.4) - mini_portile (0.6.0) - nokogiri (1.6.3.1) - mini_portile (= 0.6.0) - parslet (1.5.0) - blankslate (~> 2.0) - posix-spawn (0.3.9) - pygments.rb (0.6.0) + jekyll-paginate (1.1.0) + jekyll-redirect-from (0.11.0) + jekyll (>= 2.0) + jekyll-sass-converter (1.4.0) + sass (~> 3.4) + jekyll-watch (1.4.0) + listen (~> 3.0, < 3.1) + json (2.0.1) + kramdown (1.11.1) + liquid (3.0.6) + listen (3.0.8) + rb-fsevent (~> 0.9, >= 0.9.4) + rb-inotify (~> 0.9, >= 0.9.7) + mercenary (0.3.6) + mini_portile2 (2.1.0) + nokogiri (1.6.8) + mini_portile2 (~> 2.1.0) + pkg-config (~> 1.1.7) + nokogiri (1.6.8-x64-mingw32) + mini_portile2 (~> 2.1.0) + pkg-config (~> 1.1.7) + pkg-config (1.1.7) + posix-spawn (0.3.11) + pygments.rb (0.6.3) posix-spawn (~> 0.3.6) - yajl-ruby (~> 1.1.0) - rake (10.3.2) - rb-fsevent (0.9.4) - rb-inotify (0.9.5) + yajl-ruby (~> 1.2.0) + rake (11.2.2) + rb-fsevent (0.9.7) + rb-inotify (0.9.7) ffi (>= 0.5.0) - redcarpet (3.1.2) + redcarpet (3.3.4) + rouge (1.11.1) safe_yaml (1.0.4) - sanitize (2.0.6) + sanitize (2.1.0) nokogiri (>= 1.4.4) - sass (3.3.14) - timers (1.1.0) - toml (0.1.1) - parslet (~> 1.5.0) - yajl-ruby (1.1.0) + sass (3.4.22) + yajl-ruby (1.2.1) PLATFORMS ruby + x64-mingw32 DEPENDENCIES - jekyll (~> 2.0) + jekyll (~> 3.1) + jekyll-paginate jekyll-redirect-from json + pygments.rb rake rb-fsevent + redcarpet sanitize (~> 2.0) BUNDLED WITH - 1.10.1 + 1.11.2 diff --git a/docs/_config.yml b/docs/_config.yml index a4bdbce138..1c85394736 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -5,21 +5,37 @@ url: https://facebook.github.io baseurl: "/react" permalink: "/blog/:year/:month/:day/:title.html" paginate_path: "/blog/page:num/" -relative_permalinks: true paginate: 5 timezone: America/Los_Angeles highlighter: pygments defaults: - scope: path: '' - type: post + type: posts values: layout: post + sectionid: blog +- scope: + path: blog + type: pages + values: + sectionid: blog - scope: path: docs - type: page + type: pages values: layout: docs + sectionid: docs +- scope: + path: tips + type: pages + values: + sectionid: docs +- scope: + path: contributing + type: pages + values: + sectionid: docs exclude: - Gemfile - Gemfile.lock @@ -36,13 +52,14 @@ sass: sass_dir: _css gems: - jekyll-redirect-from -react_version: 15.2.1 +- jekyll-paginate +react_version: 15.3.0 react_hashes: - dev: g2900ZIpFKhyIsz+bnx4YDEfAISugYRU58ljeAgI8TZ0A0AkRLGUCN7OmjF16Cj+ - prod: ICzDcvbNpMy31akJ8WzksHoK9tl1iRIUPRCaBRN+sn/k40TNGjs9IvgPN0SekkDT - addons_dev: js+Yc2Nd259A4+UPokRNVOXJdipY9oIrkkDdFJAZzZxgryRJLkWYDrJVgM97aweF - addons_prod: DaNE8gIDQr8RWDoa4y9HX/70fzdOBzpV/e+7RJtMN1MnXEiCMpiIFtutJml6mvPC - dom_dev: LD1cH7LXOdrrq5dOOiE2N/HdgCyrw3nmUMq6oPFCJKUfWO3i7AozvBKz7G3maMHt - dom_prod: 1dLXeik7kFcDPXbz3rX9dibLTGh/D8dpAOL5X2Ml09pH8wpQlpL+JOgOnzAMCO4T - dom_server_dev: WJt1y2JljJEQ1OgpupP2ly0GgIwi7Aodp+n+/fv2bakpgWpXMnLklj5rSouRJt59 - dom_server_prod: Y6UDASOvQhWWBwXy/Ccp4vSAt0YAp+ymuRXBX4hffy+pMlOgjXzryIjbiceIB6GF + dev: R8v794QN9hrNjnivoQ3Mf7nMGVwFIHBkUmBanB40ZBIMttZbBEUatXNosjytvPUC + prod: asiNTW+3f/iCKtm+05EX+4V4n6R5R1fyAY9M8Md0DLHodFResXMSBlt8ns9iJaPK + addons_dev: iR3HmJX+5siYwRvy6ZXWWN/dNP4IuItUsfk0JJmwxaBIYtWHZhK/2N7wrAcxmpS8 + addons_prod: A/63GcxBS05SAxTWB0+wQKyQl8RVEH3nOuBuxwg/WV6yI5qpfEy4ksn90bqJdFJY + dom_dev: PKr8yTHUBD0chzmoJ6ZYtB1nB87GTEWPmuDlDV7iARDrYGki2fmVB0ae3vf3LX0O + dom_prod: TBEslZF7tpwiuBgt/ajgWUKvDGuCExkmEoWygscHE/OOajWS24BLAaf2/z7lj/9n + dom_server_dev: UxEqwIE5+BLQKOqKHnPfJBOrSDo7HyocIl6sTb6taLayrVmDuhQ5VM4iauS54BbK + dom_server_prod: hOLRkO2HGPRi0d73qKZWueHZyDD/6BID0CJax9kNUNaAvMR4atbNIcYfk2BoM8T3 diff --git a/docs/_data/nav_contributing.yml b/docs/_data/nav_contributing.yml new file mode 100644 index 0000000000..b1dcc5c80b --- /dev/null +++ b/docs/_data/nav_contributing.yml @@ -0,0 +1,4 @@ +- title: Contributing + items: + - id: design-principles + title: Design Principles diff --git a/docs/_includes/nav_docs.html b/docs/_includes/nav_docs.html index b3e8a277f5..560170606d 100644 --- a/docs/_includes/nav_docs.html +++ b/docs/_includes/nav_docs.html @@ -35,4 +35,18 @@ {% endfor %} + + + {% for section in site.data.nav_contributing %} + + {% endfor %} diff --git a/docs/_layouts/contributing.html b/docs/_layouts/contributing.html new file mode 100644 index 0000000000..fc5bfbadae --- /dev/null +++ b/docs/_layouts/contributing.html @@ -0,0 +1,23 @@ +--- +layout: default +sectionid: contributing +--- + +
+ {% include nav_docs.html %} + +
+

{{ page.title }}

+
{{ page.description }}
+ {{ content }} + +
+ {% if page.prev %} + ← Prev + {% endif %} + {% if page.next %} + Next → + {% endif %} +
+
+
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html index a503c5f8b3..d42b8b1572 100644 --- a/docs/_layouts/default.html +++ b/docs/_layouts/default.html @@ -50,7 +50,7 @@ React