Merge branch 'master' into master

2025-04-06 15:31:16 +08:00 · 2017-05-30 07:54:34 +02:00 · 2017-05-30 07:54:34 +02:00 · 51d6e66abd
commit 51d6e66abd
parent 1dd345ba5f 8e955b1da7
40 changed files with 523 additions and 152 deletions
--- a/.spelling
+++ b/.spelling
@ -0,0 +1,91 @@
+# markdown-spellcheck spelling configuration file
+# Format - lines beginning # are comments
+# global dictionary is at the start, file overrides afterwards
+# one word per line, to define a file override use ' - filename'
+# where filename is relative to this configuration file
+addon
+1
+vue
+webcomponents
+aurelia
+iframe
+webpack
+addons
+styleguide-type
+styleguides
+angularjs
+api
+github
+config
+cra
+PRs
+cleanup
+2
+ES2016
+prerelease
+rc
+npm
+apollo
+codemod
+storyshots
+graphql
+lerna
+eslint
+js
+CommonJS
+IO
+reflow
+Node.js.
+dialog
+10
+unisolated
+3
+13
+Browserify
+bundlers
+2013
+centered
+center
+GraphiQL
+graphiql
+url
+javascript
+storyshots'
+storybook.js.org
+CRNA
+postmessage
+websocket
+EventEmitter
+codemods
+jscodeshift
+npm3
+HMR
+Redux
+storybook-ui
+react-komposer
+redux
+serializable
+params
+ - addons/actions/node_modules/@storybook/addons/README.md
+storybooks.js.org
+ - addons/actions/node_modules/asap/README.md
+YuzuJS
+setImmediate
+Malte
+Ubl
+Katić
+Domenic
+Kowal
+Zakas
+ - addons/actions/node_modules/balanced-match/README.md
+Gruber
+julian
+juliangruber.com
+ - addons/actions/node_modules/brace-expansion/README.md
+Schlueter
+ - addons/links/README.md
+linkTo
+ - lib/ui/README.md
+setOptions
+setStories
+onStory
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -1,7 +1,5 @@
 # 3.0.0

-2017-May-27
-
 Storybook 3.0 is our first fully community-driven release! Notable changes:

 -   Moved from `@kadira` to `@storybooks` org across [github](https://github.com/storybooks/storybook/), [npm](https://www.npmjs.com/package/@storybook/react), [docs](https://storybook.js.org/)
@ -11,45 +9,66 @@ Storybook 3.0 is our first fully community-driven release! Notable changes:
 -   Added `create-react-native-app` support. <https://github.com/storybooks/storybook/pull/1117>
 -   Added HTTPS support. <https://github.com/storybooks/storybook/pull/735>

-This is a major release with breaking changes. See our [migration guide](https://github.com/storybooks/storybook/blob/master/MIGRATION.md) for details.
+2017-May-28

 #### Features

-   Added CRNA support (#1117)
-   [Addon-Knobs] Fixing performance issues. (#1039)
-   Allow HTTPS (#735)
+-   Added `create-react-native-app` support [#1117](https://github.com/storybooks/storybook/pull/1117)
+-   Fixed knobs-addon performance issues [#1039](https://github.com/storybooks/storybook/pull/1039)
+-   Added `snapshotWithOptions` to configure storyshots rendering options [#1090](https://github.com/storybooks/storybook/pull/1090)
+-   Added custom `test` function for storyshots [#1035](https://github.com/storybooks/storybook/pull/1035)
+-   Added typescript definition to addon notes [#989](https://github.com/storybooks/storybook/pull/989)
+-   Added HTTPS option for dev server [#735](https://github.com/storybooks/storybook/pull/735)

 #### Bug Fixes

-   FIX for test-cra was breaking the build (#972)
+-   FIX addon info and addon storyshots incompatibility [#1129](https://github.com/storybooks/storybook/pull/1129)
+-   FIX postcss options missing in default webpack config && UPDATE dependencies [#1087](https://github.com/storybooks/storybook/pull/1087)
+-   Fix CLI had a package version from storybook hardcoded - now queries npm registry [#1079](https://github.com/storybooks/storybook/pull/1079)
+-   Fix semi broken __docgenInfo integration in addon info [#1030](https://github.com/storybooks/storybook/pull/1030)
+-   Fix: build-storybook no longer supports relative paths [#1058](https://github.com/storybooks/storybook/pull/1058)
+-   Fix for types `number` for addon knobs [#1001](https://github.com/storybooks/storybook/pull/1001)
+-   Fix webpack overriding && Add an example with local file dependencies [#965](https://github.com/storybooks/storybook/pull/965)

 #### Documentation

-   adds ReactSVGPanZoom to examples list (#1139)
-   docs(custom-webpack-config): rules not loaders (#1137)
+-   3.0.0 release notes && release notes automation [#1047](https://github.com/storybooks/storybook/pull/1047)
+-   3.0.0 migration assistance : codemod, update installation and usage instructions [#1093](https://github.com/storybooks/storybook/pull/1093)
+-   Add ReactSVGPanZoom to examples list [#1139](https://github.com/storybooks/storybook/pull/1139)
+-   Show webpack 2 config example in docs: rules not loaders [#1137](https://github.com/storybooks/storybook/pull/1137)
+-   Merge docs repo into this repo: add /docs [#1131](https://github.com/storybooks/storybook/pull/1131)
+-   Change brand name from “React Storybook” to “Storybook” [#1044](https://github.com/storybooks/storybook/pull/1044)
+-   Updated issue triage guidelines [#1024](https://github.com/storybooks/storybook/pull/1024)

 #### Maintenance

-   refactor: change NPM organisation from kadira to storybook (#996)
-   CHANGE folder structure && CHANGE package-names (#1031)
+-   Add react-dom to the devDependency list for React Native projects [#1102](https://github.com/storybooks/storybook/pull/1102)
+-   Upgrade React Native to webpack 2 config [#1097](https://github.com/storybooks/storybook/pull/1097)
+-   Add unit tests for addon storyshots [#971](https://github.com/storybooks/storybook/pull/971)
+-   Deprecate builtin addons (links and actions) - no longer included by default [#1038](https://github.com/storybooks/storybook/pull/1038)
+-   change NPM organisation from kadira to storybook in code [#996](https://github.com/storybooks/storybook/pull/996)
+-   CHANGE folder structure && CHANGE package-names [#1031](https://github.com/storybooks/storybook/pull/1031)
+-   Add deprecation warnings when addons are required via main package [#1025](https://github.com/storybooks/storybook/pull/1025)
+-   Remove text transform uppercase for knob labels [#991](https://github.com/storybooks/storybook/pull/991)

 #### Dependency Upgrades

 <details>
 <summary>
-10 PRs
+11 PRs
 </summary>

-   Update lerna to the latest version 🚀 (<https://github.com/storybooks/storybook/pulls/1101>)
-   update dependencies in cra-storybook (<https://github.com/storybooks/storybook/pulls/1080>)
-   Switch back to non-fork of react-inspector (<https://github.com/storybooks/storybook/pulls/1026>)
-   Dependency updates (<https://github.com/storybooks/storybook/pulls/1008>)
-   Update jest to the latest version 🚀 (<https://github.com/storybooks/storybook/pulls/998>)
-   CHANGE to use react-split-view 0.1.63 over the fork (<https://github.com/storybooks/storybook/pulls/956>)
-   FIX webpack overriding && CLEANUP && ADD example (<https://github.com/storybooks/storybook/pulls/965>)
-   Update lerna to the latest version 🚀 (<https://github.com/storybooks/storybook/pulls/915>)
-   Use jest for unittesting - standardize unit testing epic (<https://github.com/storybooks/storybook/pulls/904>)
-   Update dependencies to enable Greenkeeper 🌴 (<https://github.com/storybooks/storybook/pulls/768>)
+-   Update lerna to the latest version 🚀 [#1101](https://github.com/storybooks/storybook/pull/1101)
+-   CHANGE to prop-types package for notes & test-cra [#1082](https://github.com/storybooks/storybook/pull/1082)
+-   update dependencies in cra-storybook [#1080](https://github.com/storybooks/storybook/pull/1080)
+-   Switch back to non-fork of react-inspector [#1026](https://github.com/storybooks/storybook/pull/1026)
+-   Dependency updates: webpack, babel, react [#1008](https://github.com/storybooks/storybook/pull/1008)
+-   Update jest to the latest version 🚀 [#998](https://github.com/storybooks/storybook/pull/998)
+-   Update lerna to the latest version 🚀 [#969](https://github.com/storybooks/storybook/pull/969)
+-   CHANGE to use react-split-view 0.1.63 over the fork [#956](https://github.com/storybooks/storybook/pull/956)
+-   Update lerna to the latest version 🚀 [#915](https://github.com/storybooks/storybook/pull/915)
+-   Use jest for unittesting - standardize unit testing epic [#904](https://github.com/storybooks/storybook/pull/904)
+-   Update dependencies to enable Greenkeeper 🌴 [#768](https://github.com/storybooks/storybook/pull/768)

 </details>

@ -57,74 +76,148 @@ This is a major release with breaking changes. See our [migration guide](https:/

 <details>
 <summary>
-65 PRs
+32 PRs
 </summary>

-   Add travis deploy key (<https://github.com/storybooks/storybook/pulls/1135>)
-   ADD a global to storyshots to make it work for series with info addon (<https://github.com/storybooks/storybook/pulls/1129>)
-   Removed unsafe Storyshots import (<https://github.com/storybooks/storybook/pulls/1124>)
-   Update all package.json with monorepo metadata (<https://github.com/storybooks/storybook/pulls/1111>)
-   Add react-dom to the devDependency list for React Native projects (<https://github.com/storybooks/storybook/pulls/1102>)
-   Added `snapshotWithOptions` to allow configuring rendering options in Storyshots (<https://github.com/storybooks/storybook/pulls/1090>)
-   Upgrade React Native webpack config to webpack 2 (<https://github.com/storybooks/storybook/pulls/1097>)
-   Fix dead link to demo repository (<https://github.com/storybooks/storybook/pulls/1091>)
-   FIX postcss options missing && UPDATE dependencies (<https://github.com/storybooks/storybook/pulls/1087>)
-   fix(knobs): increase font size label (<https://github.com/storybooks/storybook/pulls/1086>)
-   CHANGE to prop-types package for notes & test-cra (<https://github.com/storybooks/storybook/pulls/1082>)
-   Configure snapshot test (<https://github.com/storybooks/storybook/pulls/1035>)
-   Test storyshots (<https://github.com/storybooks/storybook/pulls/971>)
-   IMPROVE cli (<https://github.com/storybooks/storybook/pulls/1079>)
-   Update package.json with repository info (<https://github.com/storybooks/storybook/pulls/1078>)
-   Update storyshots README.md example (<https://github.com/storybooks/storybook/pulls/1076>)
-   Added component description from **docgenInfo, Added the ability to get the PropType from **docgenInfo for prop table, Fixed an issue with PropVal rendering an object (<https://github.com/storybooks/storybook/pulls/1030>)
-   Upgraded webpack PostCSS plugin definition (<https://github.com/storybooks/storybook/pulls/1062>)
-   Update link to Storyshots addon (<https://github.com/storybooks/storybook/pulls/1074>)
-   chore(jest): update to v20's default configuration file (<https://github.com/storybooks/storybook/pulls/1063>)
-   Added error message for missing or invalid storyName (<https://github.com/storybooks/storybook/pulls/747>)
-   Activating Open Collective (<https://github.com/storybooks/storybook/pulls/1065>)
-   1052-resolve-output-path (<https://github.com/storybooks/storybook/pulls/1058>)
-   MOVE & RENAME and storyshots && CHANGE “React Storybook” > “Storybook” (<https://github.com/storybooks/storybook/pulls/1044>)
-   Deprecate builtin addons (<https://github.com/storybooks/storybook/pulls/1038>)
-   Updated issue triage guidelines (<https://github.com/storybooks/storybook/pulls/1024>)
-   Deprecate built-in addons (<https://github.com/storybooks/storybook/pulls/1025>)
-   Add addonlinks repo (<https://github.com/storybooks/storybook/pulls/1021>)
-   Add propTablesExclude option (<https://github.com/storybooks/storybook/pulls/924>)
-   Add typescript definition to addon-notes (<https://github.com/storybooks/storybook/pulls/989>)
-   Fixes for types for knobs `number` (<https://github.com/storybooks/storybook/pulls/1001>)
-   First pass at update the contribution instructions (<https://github.com/storybooks/storybook/pulls/982>)
-   Remove text transform uppercase for knob labels (<https://github.com/storybooks/storybook/pulls/991>)
-   Update links in PRs section of CONTRIBUTING.md (<https://github.com/storybooks/storybook/pulls/992>)
-   Updated dead getstorybook.io links to storybooks.js.org (<https://github.com/storybooks/storybook/pulls/988>)
-   Do not ignore story.js in prepublish (<https://github.com/storybooks/storybook/pulls/973>)
-   addon-info: make the info overlay be fixed  (<https://github.com/storybooks/storybook/pulls/914>)
-   Update lerna to the latest version 🚀 (<https://github.com/storybooks/storybook/pulls/969>)
-   Handle null elements in getData (<https://github.com/storybooks/storybook/pulls/926>)
-   add description field from \_\_docgenInfo for prop table for info plugin (<https://github.com/storybooks/storybook/pulls/929>)
-   \#959 add a max-height and center element with alignItems: center (<https://github.com/storybooks/storybook/pulls/961>)
-   Switch to the only prepublish script (<https://github.com/storybooks/storybook/pulls/903>)
-   PR review policy (<https://github.com/storybooks/storybook/pulls/923>)
-   Add typescript definitions for getStorybook() (<https://github.com/storybooks/storybook/pulls/753>)
-   Restore deep link for addon docs (<https://github.com/storybooks/storybook/pulls/919>)
-   Fix default storybook webpack config (<https://github.com/storybooks/storybook/pulls/922>)
-   Render the first story for a kind if no story selected. (<https://github.com/storybooks/storybook/pulls/918>)
-   Update docs for monorepo (<https://github.com/storybooks/storybook/pulls/913>)
-   Monorepo readme and contributing (<https://github.com/storybooks/storybook/pulls/907>)
-   Add story kind regex (<https://github.com/storybooks/storybook/pulls/906>)
-   Add examples (<https://github.com/storybooks/storybook/pulls/897>)
-   Add missing repos (<https://github.com/storybooks/storybook/pulls/882>)
-   Switch to monorepo (<https://github.com/storybooks/storybook/pulls/749>)
-   extend devMiddlewareOptions with config.devServer (<https://github.com/storybooks/storybook/pulls/723>)
-   Added meta IE=edge (<https://github.com/storybooks/storybook/pulls/715>)
-   Replace String.includes with String.indexOf: cross-browsing support (<https://github.com/storybooks/storybook/pulls/712>)
-   Issue Triage instructions (<https://github.com/storybooks/storybook/pulls/748>)
-   Simple pull request template (<https://github.com/storybooks/storybook/pulls/741>)
-   Make return type of StoryDecorator nullable (<https://github.com/storybooks/storybook/pulls/680>)
-   Warn if story with a given name already exists (<https://github.com/storybooks/storybook/pulls/670>)
-   Fix spelling mistake - "element form the story" to  "element from the story" (<https://github.com/storybooks/storybook/pulls/702>)
-   Remove broken react-button example (<https://github.com/storybooks/storybook/pulls/699>)
-   Fixed spelling error. (<https://github.com/storybooks/storybook/pulls/720>)
-   Cleaner error handling for storiesOf (<https://github.com/storybooks/storybook/pulls/672>)
-   Update links to point to new organization (<https://github.com/storybooks/storybook/pulls/721>)
+-   Update link to Storyshots addon [#1074](https://github.com/storybooks/storybook/pull/1074)
+-   Added error message for missing or invalid storyName [#747](https://github.com/storybooks/storybook/pull/747)
+-   Opened an Open Collective Account https://opencollective.com/storybook [#1065](https://github.com/storybooks/storybook/pull/1065)
+-   Add propTablesExclude option [#924](https://github.com/storybooks/storybook/pull/924)
+-   addon-info: make the info overlay be fixed  [#914](https://github.com/storybooks/storybook/pull/914)
+-   Handle null elements in getData [#926](https://github.com/storybooks/storybook/pull/926)
+-   add description field from __docgenInfo for prop table for info plugin [#929](https://github.com/storybooks/storybook/pull/929)
+-   #959 add a max-height and center element with alignItems: center [#961](https://github.com/storybooks/storybook/pull/961)
+-   Switch to the only prepublish script [#903](https://github.com/storybooks/storybook/pull/903)
+-   PR review policy [#923](https://github.com/storybooks/storybook/pull/923)
+-   Add typescript definitions for getStorybook() [#753](https://github.com/storybooks/storybook/pull/753)
+-   Restore deep link for addon docs [#919](https://github.com/storybooks/storybook/pull/919)
+-   Fix default storybook webpack config [#922](https://github.com/storybooks/storybook/pull/922)
+-   Render the first story for a kind if no story selected. [#918](https://github.com/storybooks/storybook/pull/918)
+-   Update docs for monorepo [#913](https://github.com/storybooks/storybook/pull/913)
+-   Monorepo readme and contributing [#907](https://github.com/storybooks/storybook/pull/907)
+-   Add story kind regex [#906](https://github.com/storybooks/storybook/pull/906)
+-   Add examples [#897](https://github.com/storybooks/storybook/pull/897)
+-   Add missing repos [#882](https://github.com/storybooks/storybook/pull/882)
+-   Switch to monorepo [#749](https://github.com/storybooks/storybook/pull/749)
+-   extend devMiddlewareOptions with config.devServer [#723](https://github.com/storybooks/storybook/pull/723)
+-   Added meta IE=edge [#715](https://github.com/storybooks/storybook/pull/715)
+-   Replace String.includes with String.indexOf: cross-browsing support [#712](https://github.com/storybooks/storybook/pull/712)
+-   Issue Triage instructions [#748](https://github.com/storybooks/storybook/pull/748)
+-   Simple pull request template [#741](https://github.com/storybooks/storybook/pull/741)
+-   Make return type of StoryDecorator nullable [#680](https://github.com/storybooks/storybook/pull/680)
+-   Warn if story with a given name already exists [#670](https://github.com/storybooks/storybook/pull/670)
+-   Fix spelling mistake - "element form the story" to  "element from the story" [#702](https://github.com/storybooks/storybook/pull/702)
+-   Remove broken react-button example [#699](https://github.com/storybooks/storybook/pull/699)
+-   Fixed spelling error. [#720](https://github.com/storybooks/storybook/pull/720)
+-   Cleaner error handling for storiesOf [#672](https://github.com/storybooks/storybook/pull/672)
+-   Update links to point to new organization [#721](https://github.com/storybooks/storybook/pull/721)
+
+</details>
+
+# 3.0.0
+
+2017-May-28
+
+#### Features
+
+-   Added create-react-native-app support [#231042620](https://github.com/storybooks/storybook/pull/231042620)
+-   Fixed knobs-addon performance issues [#229059492](https://github.com/storybooks/storybook/pull/229059492)
+-   Added `snapshotWithOptions` to configure storyshots rendering options [#230288359](https://github.com/storybooks/storybook/pull/230288359)
+-   Added custom `test` function for storyshots [#228610901](https://github.com/storybooks/storybook/pull/228610901)
+-   Added typescript definition to addon notes [#225951611](https://github.com/storybooks/storybook/pull/225951611)
+-   Added HTTPS option for dev server [#218358860](https://github.com/storybooks/storybook/pull/218358860)
+
+#### Bug Fixes
+
+-   FIX addon info and addon storyshots incompatibility [#231375861](https://github.com/storybooks/storybook/pull/231375861)
+-   FIX postcss options missing in default webpack config && UPDATE dependencies [#230235969](https://github.com/storybooks/storybook/pull/230235969)
+-   Fix CLI had a package version from storybook hardcoded - now queries npm registry [#230162081](https://github.com/storybooks/storybook/pull/230162081)
+-   Fix semi broken __docgenInfo integration in addon info [#228501269](https://github.com/storybooks/storybook/pull/228501269)
+-   Fix: build-storybook no longer supports relative paths [#229662130](https://github.com/storybooks/storybook/pull/229662130)
+-   Fix for types `number` for addon knobs [#226931856](https://github.com/storybooks/storybook/pull/226931856)
+-   Fix webpack overriding && Add an example with local file dependencies [#224884216](https://github.com/storybooks/storybook/pull/224884216)
+
+#### Documentation
+
+-   3.0.0 release notes && release notes automation [#229400945](https://github.com/storybooks/storybook/pull/229400945)
+-   3.0.0 migration assistance : codemod, update installation and usage instructions [#230404473](https://github.com/storybooks/storybook/pull/230404473)
+-   Add ReactSVGPanZoom to examples list [#231785266](https://github.com/storybooks/storybook/pull/231785266)
+-   Show webpack 2 config example in docs: rules not loaders [#231777090](https://github.com/storybooks/storybook/pull/231777090)
+-   Merge docs repo into this repo: add /docs [#231485302](https://github.com/storybooks/storybook/pull/231485302)
+-   Change brand name from “React Storybook” to “Storybook” [#229256692](https://github.com/storybooks/storybook/pull/229256692)
+-   Updated issue triage guidelines [#228248588](https://github.com/storybooks/storybook/pull/228248588)
+
+#### Maintenance
+
+-   Add react-dom to the devDependency list for React Native projects [#230627256](https://github.com/storybooks/storybook/pull/230627256)
+-   Upgrade React Native to webpack 2 config [#230519132](https://github.com/storybooks/storybook/pull/230519132)
+-   Add unit tests for addon storyshots [#225044914](https://github.com/storybooks/storybook/pull/225044914)
+-   Deprecate builtin addons (links and actions) - no longer included by default [#228894668](https://github.com/storybooks/storybook/pull/228894668)
+-   change NPM organisation from kadira to storybook in code [#226755414](https://github.com/storybooks/storybook/pull/226755414)
+-   CHANGE folder structure && CHANGE package-names [#228527160](https://github.com/storybooks/storybook/pull/228527160)
+-   Add deprecation warnings when addons are required via main package [#228301687](https://github.com/storybooks/storybook/pull/228301687)
+-   Remove text transform uppercase for knob labels [#226097455](https://github.com/storybooks/storybook/pull/226097455)
+
+#### Dependency Upgrades
+
+<details>
+<summary>
+11 PRs
+</summary>
+
+-   Update lerna to the latest version 🚀 [#230563326](https://github.com/storybooks/storybook/pull/230563326)
+-   CHANGE to prop-types package for notes & test-cra [#230216864](https://github.com/storybooks/storybook/pull/230216864)
+-   update dependencies in cra-storybook [#230162309](https://github.com/storybooks/storybook/pull/230162309)
+-   Switch back to non-fork of react-inspector [#228406523](https://github.com/storybooks/storybook/pull/228406523)
+-   Dependency updates: webpack, babel, react [#227506568](https://github.com/storybooks/storybook/pull/227506568)
+-   Update jest to the latest version 🚀 [#226769419](https://github.com/storybooks/storybook/pull/226769419)
+-   Update lerna to the latest version 🚀 [#224944384](https://github.com/storybooks/storybook/pull/224944384)
+-   CHANGE to use react-split-view 0.1.63 over the fork [#223722248](https://github.com/storybooks/storybook/pull/223722248)
+-   Update lerna to the latest version 🚀 [#222490861](https://github.com/storybooks/storybook/pull/222490861)
+-   Use jest for unittesting - standardize unit testing epic [#222017285](https://github.com/storybooks/storybook/pull/222017285)
+-   Update dependencies to enable Greenkeeper 🌴 [#221621540](https://github.com/storybooks/storybook/pull/221621540)
+
+</details>
+
+#### Other
+
+<details>
+<summary>
+32 PRs
+</summary>
+
+-   Update link to Storyshots addon [#230051949](https://github.com/storybooks/storybook/pull/230051949)
+-   Added error message for missing or invalid storyName [#219411352](https://github.com/storybooks/storybook/pull/219411352)
+-   Opened an Open Collective Account https://opencollective.com/storybook [#229793032](https://github.com/storybooks/storybook/pull/229793032)
+-   Add propTablesExclude option [#223053163](https://github.com/storybooks/storybook/pull/223053163)
+-   addon-info: make the info overlay be fixed  [#222360406](https://github.com/storybooks/storybook/pull/222360406)
+-   Handle null elements in getData [#223366686](https://github.com/storybooks/storybook/pull/223366686)
+-   add description field from __docgenInfo for prop table for info plugin [#223519878](https://github.com/storybooks/storybook/pull/223519878)
+-   #959 add a max-height and center element with alignItems: center [#224562424](https://github.com/storybooks/storybook/pull/224562424)
+-   Switch to the only prepublish script [#222005495](https://github.com/storybooks/storybook/pull/222005495)
+-   PR review policy [#222941123](https://github.com/storybooks/storybook/pull/222941123)
+-   Add typescript definitions for getStorybook() [#220545221](https://github.com/storybooks/storybook/pull/220545221)
+-   Restore deep link for addon docs [#222762694](https://github.com/storybooks/storybook/pull/222762694)
+-   Fix default storybook webpack config [#222888979](https://github.com/storybooks/storybook/pull/222888979)
+-   Render the first story for a kind if no story selected. [#222727598](https://github.com/storybooks/storybook/pull/222727598)
+-   Update docs for monorepo [#222225048](https://github.com/storybooks/storybook/pull/222225048)
+-   Monorepo readme and contributing [#222021738](https://github.com/storybooks/storybook/pull/222021738)
+-   Add story kind regex [#222021591](https://github.com/storybooks/storybook/pull/222021591)
+-   Add examples [#221967561](https://github.com/storybooks/storybook/pull/221967561)
+-   Add missing repos [#221960877](https://github.com/storybooks/storybook/pull/221960877)
+-   Switch to monorepo [#219550577](https://github.com/storybooks/storybook/pull/219550577)
+-   extend devMiddlewareOptions with config.devServer [#213843252](https://github.com/storybooks/storybook/pull/213843252)
+-   Added meta IE=edge [#212424507](https://github.com/storybooks/storybook/pull/212424507)
+-   Replace String.includes with String.indexOf: cross-browsing support [#212267933](https://github.com/storybooks/storybook/pull/212267933)
+-   Issue Triage instructions [#219466650](https://github.com/storybooks/storybook/pull/219466650)
+-   Simple pull request template [#218781679](https://github.com/storybooks/storybook/pull/218781679)
+-   Make return type of StoryDecorator nullable [#204247531](https://github.com/storybooks/storybook/pull/204247531)
+-   Warn if story with a given name already exists [#200820130](https://github.com/storybooks/storybook/pull/200820130)
+-   Fix spelling mistake - "element form the story" to  "element from the story" [#209336442](https://github.com/storybooks/storybook/pull/209336442)
+-   Remove broken react-button example [#208526023](https://github.com/storybooks/storybook/pull/208526023)
+-   Fixed spelling error. [#213588926](https://github.com/storybooks/storybook/pull/213588926)
+-   Cleaner error handling for storiesOf [#201531268](https://github.com/storybooks/storybook/pull/201531268)
+-   Update links to point to new organization [#213621294](https://github.com/storybooks/storybook/pull/213621294)

 </details>

--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@ -117,9 +117,9 @@ If an issue is a `bug`, and it doesn't have a clear reproduction that you have p

 -   Unreproducible issues should be closed if it's not possible to reproduce them (if the reporter drops offline, it is reasonable to wait 2 weeks before closing).

-   `bug`s should be labeled `merged` when merged, and be closed when the issue is fixed and released.
+-   `bug`s should be labelled `merged` when merged, and be closed when the issue is fixed and released.

-   `feature`s, `maintenance`s, `greenkeeper`s should be labeled `merged` when merged, and closed when released or if the feature is deemed not appropriate.
+-   `feature`s, `maintenance`s, `greenkeeper`s should be labelled `merged` when merged, and closed when released or if the feature is deemed not appropriate.

 -   `question / support`s should be closed when the question has been answered. If the questioner drops offline, a reasonable period to wait is two weeks.

--- a/HISTORY.md
+++ b/HISTORY.md
@ -1,6 +1,6 @@
 ## v.Next

-   Deprecated `{ linkTo, action }` as built-in addons: <https://github.com/storybooks/storybook/issues/1017>. From 3.0 use them as you would [any other addon](https://storybooks.js.org/docs/react-storybook/addons/using-addons/).
+-   Deprecated `{ linkTo, action }` as built-in addons: <https://github.com/storybooks/storybook/issues/1017>. From 3.0 use them as you would [any other addon](https://storybook.js.org/docs/react-storybook/addons/using-addons/).

 Before:

--- a/MIGRATION.md
+++ b/MIGRATION.md
@ -24,7 +24,7 @@ You can find the guide to upgrading your webpack config [on webpack.js.org](http
 All our packages have been renamed and published to npm as version 3.0.0.

 > We have adopted the same versioning strategy as have been adopted by babel, jest and apollo.
-> It's a strategy best suited for ecosystem type tools, which consist of many seperately installable features / packages.
+> It's a strategy best suited for ecosystem type tools, which consist of many separately installable features / packages.
 > We think this describes storybook pretty well.

 The new package names are:
@ -59,13 +59,13 @@ The new package names are:

 If your codebase is small, it's probably doable to just replace them by hand. (in your codebase and in `package.json`).

-But if you have a lot of occurances in your codebase, you can use a [codemod we created](./lib/codemod) for you.
+But if you have a lot of occurrences in your codebase, you can use a [codemod we created](./lib/codemod) for you.

 > A codemod makes automatic changed to your app's code.

 You have to change your `package.json`, prune old and install new dependencies by hand.

-`npm prune` will remove all dependecies from `node_modules` which are no longer referenced in `package.json`.
+`npm prune` will remove all dependencies from `node_modules` which are no longer referenced in `package.json`.

 ### Deprecated embedded addons

--- a/README.md
+++ b/README.md
@ -19,7 +19,7 @@ It allows you to browse a component library, view the different states of each c

 Storybook runs outside of your app. This allows you to develop UI components in isolation, which can improve component reuse, testability, and development speed. You can build quickly without having to worry about application-specific dependencies.

-Storybook comes with a lot of [addons](https://storybooks.js.org/docs/react-storybook/addons/introduction) for component design, documentation, testing, interactivity, and so on. Storybook's easy-to-use API makes it easy to configure and extend in various ways. It has even been extended to support React Native development for mobile.
+Storybook comes with a lot of [addons](https://storybook.js.org/docs/react-storybook/addons/introduction) for component design, documentation, testing, interactivity, and so on. Storybook's easy-to-use API makes it easy to configure and extend in various ways. It has even been extended to support React Native development for mobile.

 ## Table of contents

@ -45,7 +45,7 @@ getstorybook

 Once it's installed, you can `npm run storybook` and it will run the development server on your local machine, and give you a URL to browse some sample stories.

-For full documentation on using Storybook visit: [storybooks.js.org](https://storybooks.js.org)
+For full documentation on using Storybook visit: [storybook.js.org](https://storybook.js.org)

 ## Projects

@ -95,14 +95,14 @@ We welcome contributions to Storybook!
 -   `npm run lint:js` - will check js
 -   `npm run lint:markdown` - will check markdown + code samples

-   `npm run lint:js -- --fix` - will autofix js
-   `npm run lint:markdown -- -o` - will autofix markdown
+-   `npm run lint:js -- --fix` - will automatically fix js
+-   `npm run lint:markdown -- -o` - will automatically fix markdown

 #### `npm run test`

-> boolean check if unittests all pass - uses jest
+> boolean check if unit tests all pass - uses jest

-   `npm run test:watch` - will run tests in watchmode
+-   `npm run test:watch` - will run tests in watch-mode

 ### Backers

--- a/ROADMAP.md
+++ b/ROADMAP.md
@ -1,14 +1,121 @@
 # Roadmap

-### Short Term
+## Table of contents

-   Mobile support
-   Addon API and addons
-   A clear guide to hack Storybook
-   React Native Support
+-   [New features](#new-features)
+    -   [Responsive + multi-device viewports preview.](#responsive--multi-device-viewports-preview)
+    -   [Automatic story detection](#automatic-story-detection)
+    -   [Theme ability and override core UI components](#theme-ability-and-override-core-ui-components)
+    -   [Add a playground addon](#add-a-playground-addon)
+    -   [See multiple (or all) stories in 1 preview.](#see-multiple-or-all-stories-in-1-preview)
+    -   [Deeper level hierarchy](#deeper-level-hierarchy)
+-   [Supporting other frameworks and libraries](#supporting-other-frameworks-and-libraries)
+    -   [Vue](#vue)
+    -   [Angular](#angular)
+    -   [Webcomponents](#webcomponents)
+    -   [Polymer](#polymer)
+    -   [Aurelia](#aurelia)
+-   [Breaking changes](#breaking-changes)
+    -   [Addon API](#addon-api)
+    -   [API for adding stories](#api-for-adding-stories)
+-   [Documentation](#documentation)
+    -   [Search & Structure](#search--structure)
+    -   [Better design](#better-design)
+    -   [Record videos and write blog post on how to tweak storybook](#record-videos-and-write-blog-post-on-how-to-tweak-storybook)

-### Long Term
+## New features

-   Automatic story generation (and edge case detection) based on propTypes.
-   Angular Support
-   Vue Support
+Doing these will be backwards compatible.
+
+### Responsive + multi-device viewports preview.
+
+If you're smart about it you can already view the preview on multiple devices and windows. It's just an iframe after-all.
+But story selection and addon-settings are not synced.
+We want to make this much much simpler and really are core feature of storybook.
+
+### Automatic story detection
+
+Some tools are doing automatic file detection, jest for example.
+We think such a feature is highly needed. A lot of users are already hacking this themselves using webpack specific features.
+
+### Theme ability and override core UI components
+
+Storybook is often used inside product companies and agencies. We want to help them have a sense of quality and immersion.
+We're interested in full customizability of our UI, though addons and options.
+
+### Add a playground addon
+
+Many other styleguide-type projects have what's called a playground, where developers can change the code rendering the component inside the app.
+Storybook has of course a very tight connection with your editor, and it has a knobs addon.
+But we still see value in an addon that will allow the workflow of a playground.
+
+### See multiple (or all) stories in 1 preview.
+
+Storybook's philosophy is about describing small bits in a variety of states.
+However some components are best understood when viewed in multiple varieties in 1 view.
+It's quite common to see users write a single story, with a wrapper components and multiple instances of the component the story is about.
+We plan to add a second mode to storybook that will allow you to see all stories in 1 preview.
+That way you can write your stories how they are best, and preview them how you like.
+
+### Deeper level hierarchy
+
+A very long standing issue is about "what about larger styleguides?". Some styleguides have lots and lots of components.
+At some point is becomes unmaintainable if you do not group them somehow.
+Storybook's UI is not exactly setup for very large styleguides, right now.
+But we are going to add a way of defining groups! And develop a UI that allows you to quickly navigate to other groups / stories.
+
+## Supporting other frameworks and libraries
+
+We believe in the power of react, and think it's the right choice for a lot of projects.
+But it's up to you and your team to decide your stack.
+Unfortunately if you choose anything other then React or React-Native you can not use storybook.
+
+We want you to be able to use storybook with the framework / library of your choice.
+
+### Vue
+
+Interested in supporting. We know about [vue-play](https://github.com/vue-play/vue-play/), we're interested in learning and working together!
+
+### Angular
+
+Interested in supporting ( not AngularJS ).
+
+### Webcomponents
+
+Interested in supporting.
+
+### Polymer
+
+Interested in supporting, once bower and html-imports are gone.
+
+### Aurelia
+
+Please contact us if you want this.
+
+## Breaking changes
+
+### Addon API
+
+Our addon api is limited and will eventually have to be improved to accommodate better more optimized and modern addons.
+
+### API for adding stories
+
+Currently it's getting hard to setup a story that has data / options for multiple addons.
+We want to support this, but will likely mean we will have to change the `add` method's API.
+
+## Documentation
+
+### Search & Structure
+
+Finding the right part of our documentation isn't easy, since there is no search.
+We want to integrate the readme of the individual packages into the documentation site and also have the changelog, contributing, migration and roadmap findable there.
+
+### Better design
+
+We have a new logo, so next step is a overhaul of our documentation site.
+
+### Record videos and write blog post on how to tweak storybook
+
+This may include writing addons, choosing the right addons etc.
+Also how to start developing on our codebase.
+Also how to use storybook itself and the CLI.
--- a/addons/actions/README.md
+++ b/addons/actions/README.md
@ -7,7 +7,7 @@
 [![BCH compliance](https://bettercodehub.com/edge/badge/storybooks/storybook)](https://bettercodehub.com/results/storybooks/storybook) [![codecov](https://codecov.io/gh/storybooks/storybook/branch/master/graph/badge.svg)](https://codecov.io/gh/storybooks/storybook)
 [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

-Storybook Addon Actions can be used to display data received by event handlers in [Storybook](https://storybooks.js.org).
+Storybook Addon Actions can be used to display data received by event handlers in [Storybook](https://storybook.js.org).

 This addon works with Storybook for:
 [React](https://github.com/storybooks/storybook/tree/master/app/react) and
@ -17,7 +17,10 @@ This addon works with Storybook for:

 ## Getting Started

-You can use this addon without installing it manually.
+Install:
+```sh
+npm i @storybook/addon-actions
+```

 Import the `action` function and use it to create actions handlers. When creating action handlers, provide a **name** to make it easier to identify.

--- a/addons/actions/src/containers/ActionLogger/index.js
+++ b/addons/actions/src/containers/ActionLogger/index.js
@ -14,7 +14,7 @@ export default class ActionLogger extends React.Component {
    action.data.args = action.data.args.map(arg => JSON.parse(arg));
    const actions = [...this.state.actions];
    const previous = actions.length && actions[0];
-    if (previous && deepEqual(previous.data, action.data)) {
+    if (previous && deepEqual(previous.data, action.data, { strict: true })) {
      previous.count++;
    } else {
      action.count = 1;
--- a/addons/centered/README.md
+++ b/addons/centered/README.md
@ -7,7 +7,7 @@
 [![BCH compliance](https://bettercodehub.com/edge/badge/storybooks/storybook)](https://bettercodehub.com/results/storybooks/storybook) [![codecov](https://codecov.io/gh/storybooks/storybook/branch/master/graph/badge.svg)](https://codecov.io/gh/storybooks/storybook)
 [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

-Storybook Centered Decorator can be used to center components inside the preview in [Storybook](https://storybooks.js.org).
+Storybook Centered Decorator can be used to center components inside the preview in [Storybook](https://storybook.js.org).

 This addon works with Storybook for:
 [React](https://github.com/storybooks/storybook/tree/master/app/react).
--- a/addons/comments/README.md
+++ b/addons/comments/README.md
@ -7,7 +7,7 @@
 [![BCH compliance](https://bettercodehub.com/edge/badge/storybooks/storybook)](https://bettercodehub.com/results/storybooks/storybook) [![codecov](https://codecov.io/gh/storybooks/storybook/branch/master/graph/badge.svg)](https://codecov.io/gh/storybooks/storybook)
 [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

-Storybook Comments Addon allows you to add comments for your stories in [Storybook](https://storybooks.js.org).
+Storybook Comments Addon allows you to add comments for your stories in [Storybook](https://storybook.js.org).

 This addon works with Storybook for:
 [React](https://github.com/storybooks/storybook/tree/master/app/react).
--- a/addons/graphql/README.md
+++ b/addons/graphql/README.md
@ -7,7 +7,7 @@
 [![BCH compliance](https://bettercodehub.com/edge/badge/storybooks/storybook)](https://bettercodehub.com/results/storybooks/storybook) [![codecov](https://codecov.io/gh/storybooks/storybook/branch/master/graph/badge.svg)](https://codecov.io/gh/storybooks/storybook)
 [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

-Storybook GraphiQL Addon can be used to display the GraphiQL IDE with example queries in [Storybook](https://storybooks.js.org).
+Storybook GraphiQL Addon can be used to display the GraphiQL IDE with example queries in [Storybook](https://storybook.js.org).

 This addon works with Storybook for:
 [React](https://github.com/storybooks/storybook/tree/master/app/react).
--- a/addons/info/README.md
+++ b/addons/info/README.md
@ -7,7 +7,7 @@
 [![BCH compliance](https://bettercodehub.com/edge/badge/storybooks/storybook)](https://bettercodehub.com/results/storybooks/storybook) [![codecov](https://codecov.io/gh/storybooks/storybook/branch/master/graph/badge.svg)](https://codecov.io/gh/storybooks/storybook)
 [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

-Storybook Info Addon will show additional information for your stories in [Storybook](https://storybooks.js.org).
+Storybook Info Addon will show additional information for your stories in [Storybook](https://storybook.js.org).
 Useful when you want to display usage or other types of documentation alongside your story.

 This addon works with Storybook for:
--- a/addons/knobs/README.md
+++ b/addons/knobs/README.md
@ -8,7 +8,7 @@
 [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

 Storybook Addon Knobs allow you to edit React props dynamically using the Storybook UI.
-You can also use Knobs as a dynamic variable inside stories in [Storybook](https://storybooks.js.org).
+You can also use Knobs as a dynamic variable inside stories in [Storybook](https://storybook.js.org).

 This addon works with Storybook for:
 [React](https://github.com/storybooks/storybook/tree/master/app/react).
@ -137,9 +137,9 @@ const options = {
 const value = number(label, defaultValue, options);
 ```

-### color
+### colour

-Allows you to get a color from the user.
+Allows you to get a colour from the user.

 ```js
 const label = 'Color';
--- a/addons/links/README.md
+++ b/addons/links/README.md
@ -7,7 +7,7 @@
 [![BCH compliance](https://bettercodehub.com/edge/badge/storybooks/storybook)](https://bettercodehub.com/results/storybooks/storybook) [![codecov](https://codecov.io/gh/storybooks/storybook/branch/master/graph/badge.svg)](https://codecov.io/gh/storybooks/storybook)
 [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

-The Storybook Links addon can be used to create links between stories in [Storybook](https://storybooks.js.org).
+The Storybook Links addon can be used to create links between stories in [Storybook](https://storybook.js.org).

 This addon works with Storybook for:
 [React](https://github.com/storybooks/storybook/tree/master/app/react) and
--- a/addons/links/package.json
+++ b/addons/links/package.json
@ -31,5 +31,6 @@
  "peerDependencies": {
    "react": "*",
    "react-dom": "*"
-  }
+  },
+  "typings": "./storybook-addon-links.d.ts"
 }
--- a/addons/links/storybook-addon-links.d.ts
+++ b/addons/links/storybook-addon-links.d.ts
@ -0,0 +1,3 @@
+import * as React from 'react';
+
+export function linkTo<E>(book: string, kind?: string): React.MouseEventHandler<E>;
--- a/addons/notes/README.md
+++ b/addons/notes/README.md
@ -7,7 +7,7 @@
 [![BCH compliance](https://bettercodehub.com/edge/badge/storybooks/storybook)](https://bettercodehub.com/results/storybooks/storybook) [![codecov](https://codecov.io/gh/storybooks/storybook/branch/master/graph/badge.svg)](https://codecov.io/gh/storybooks/storybook)
 [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

-Storybook Addon Notes allows you to write notes for your stories in [Storybook](https://storybooks.js.org).
+Storybook Addon Notes allows you to write notes for your stories in [Storybook](https://storybook.js.org).

 This addon works with Storybook for:
 [React](https://github.com/storybooks/storybook/tree/master/app/react).
--- a/addons/options/README.md
+++ b/addons/options/README.md
@ -7,7 +7,7 @@
 [![BCH compliance](https://bettercodehub.com/edge/badge/storybooks/storybook)](https://bettercodehub.com/results/storybooks/storybook) [![codecov](https://codecov.io/gh/storybooks/storybook/branch/master/graph/badge.svg)](https://codecov.io/gh/storybooks/storybook)
 [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

-The Options addon can be used to set configure the [Storybook](https://storybooks.js.org) UI.
+The Options addon can be used to set configure the [Storybook](https://storybook.js.org) UI.

 This addon works with Storybook for:
 [React](https://github.com/storybooks/storybook/tree/master/app/react) and
--- a/addons/storyshots/README.md
+++ b/addons/storyshots/README.md
@ -7,7 +7,7 @@
 [![BCH compliance](https://bettercodehub.com/edge/badge/storybooks/storybook)](https://bettercodehub.com/results/storybooks/storybook) [![codecov](https://codecov.io/gh/storybooks/storybook/branch/master/graph/badge.svg)](https://codecov.io/gh/storybooks/storybook)
 [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

-StoryShots adds automatic Jest Snapshot Testing for [Storybook](https://storybooks.js.org/).
+StoryShots adds automatic Jest Snapshot Testing for [Storybook](https://storybook.js.org/).

 This addon works with Storybook for:
 [React](https://github.com/storybooks/storybook/tree/master/app/react) and
@ -100,7 +100,7 @@ initStoryshots({

 ### `framework`

-If you are running tests from outside of your app's directory, storyshot's detection of which framework you are using may fail. Pass `"react"` or `"react-native"` to short-circuit this.
+If you are running tests from outside of your app's directory, storyshots' detection of which framework you are using may fail. Pass `"react"` or `"react-native"` to short-circuit this.

 ### `test`

--- a/app/react-native/readme.md
+++ b/app/react-native/readme.md
@ -11,7 +11,7 @@ With Storybook for React Native you can design and develop individual React Nati

 ![Storybook Screenshot](docs/assets/readme/screenshot.png)

-For more information visit: [storybooks.js.org](https://storybooks.js.org)
+For more information visit: [storybook.js.org](https://storybook.js.org)

 ## Getting Started

--- a/app/react-native/src/manager/components/PreviewHelp.js
+++ b/app/react-native/src/manager/components/PreviewHelp.js
@ -0,0 +1,70 @@
+import PropTypes from 'prop-types';
+import React, { Component } from 'react';
+
+class PreviewHelp extends Component {
+  render() {
+    return (
+      <div style={styles.main}>
+        <h1>Welcome to STORYBOOK</h1>
+        <p>
+          This is a UI component dev environment for your app.
+        </p>
+        <p>
+          We've added some basic stories inside the
+          {' '}
+          <span style={styles.code}>storybook/stories</span>
+          {' '}
+          directory.
+          {' '}
+          A story is a single state of one or more UI components. You can have as many stories as you want. Basically a story is like a visual test case.
+        </p>
+        <p>
+          To see your Storybook stories on the device, you should start your mobile app for the
+          {' '}
+          <span style={styles.code}>&lt;platform&gt;</span>
+          {' '}
+          of your choice (typically ios or android).
+        </p>
+        <p>
+          For <span style={styles.code}>create-react-native-app</span> apps:
+        </p>
+        <div style={styles.codeBlock}>
+          <pre style={styles.instructionsCode}>npm run &lt;platform&gt;</pre>
+        </div>
+        <p>
+          For <span style={styles.code}>react-native init</span> apps:
+        </p>
+        <div style={styles.codeBlock}>
+          <pre style={styles.instructionsCode}>npm run &lt;platform&gt;</pre>
+        </div>
+      </div>
+    );
+  }
+}
+
+const styles = {
+  main: {
+    margin: 15,
+    maxWidth: 600,
+    lineHeight: 1.4,
+    fontFamily: '"Helvetica Neue", Helvetica, "Segoe UI", Arial, freesans, sans-serif',
+  },
+
+  code: {
+    fontSize: 15,
+    fontWeight: 600,
+    padding: '2px 5px',
+    border: '1px solid #eae9e9',
+    borderRadius: 4,
+    backgroundColor: '#f3f2f2',
+    color: '#3a3a3a',
+  },
+
+  codeBlock: {
+    backgroundColor: '#f3f2f2',
+    padding: '1px 10px',
+    margin: '10px 0',
+  },
+};
+
+export default PreviewHelp;
--- a/app/react-native/src/manager/provider.js
+++ b/app/react-native/src/manager/provider.js
@ -3,6 +3,7 @@ import { Provider } from '@storybook/ui';
 import createChannel from '@storybook/channel-websocket';
 import addons from '@storybook/addons';
 import uuid from 'uuid';
+import PreviewHelp from './components/PreviewHelp';

 export default class ReactProvider extends Provider {
  constructor({ url: domain, options }) {
@ -47,7 +48,7 @@ export default class ReactProvider extends Provider {
      );
    }

-    return innerPreview;
+    return innerPreview || <PreviewHelp />;
  }

  handleAPI(api) {
--- a/app/react-native/src/server/addons.js
+++ b/app/react-native/src/server/addons.js
@ -4,5 +4,5 @@ import '@storybook/addon-links/register';

 deprecate(
  () => {},
-  '@storybook/react-native/addons is deprecated. See https://storybooks.js.org/docs/react-storybook/addons/using-addons/'
+  '@storybook/react-native/addons is deprecated. See https://storybook.js.org/docs/react-storybook/addons/using-addons/'
 )();
--- a/app/react/README.md
+++ b/app/react/README.md
@ -23,12 +23,12 @@ cd my-react-app
 getstorybook
 ```

-For more information visit: [storybooks.js.org](https://storybooks.js.org)
+For more information visit: [storybook.js.org](https://storybook.js.org)

 * * *

-Storybook also comes with a lot of [addons](https://storybooks.js.org/docs/react-storybook/addons/introduction) and a great API to customize as you wish.
-You can also build a [static version](https://storybooks.js.org/docs/react-storybook/basics/exporting-storybook) of your storybook and deploy it anywhere you want.
+Storybook also comes with a lot of [addons](https://storybook.js.org/docs/react-storybook/addons/introduction) and a great API to customize as you wish.
+You can also build a [static version](https://storybook.js.org/docs/react-storybook/basics/exporting-storybook) of your storybook and deploy it anywhere you want.

 Here are some featured storybooks that you can reference to see how Storybook works:

@ -37,6 +37,6 @@ Here are some featured storybooks that you can reference to see how Storybook wo

 ## Docs

-   [Basics](https://storybooks.js.org/docs/react-storybook/basics/introduction)
-   [Configurations](https://storybooks.js.org/docs/react-storybook/configurations/default-config)
-   [Addons](https://storybooks.js.org/docs/react-storybook/addons/introduction)
+-   [Basics](https://storybook.js.org/docs/react-storybook/basics/introduction)
+-   [Configurations](https://storybook.js.org/docs/react-storybook/configurations/default-config)
+-   [Addons](https://storybook.js.org/docs/react-storybook/addons/introduction)
--- a/app/react/addons.js
+++ b/app/react/addons.js
@ -4,5 +4,5 @@ import '@storybook/addon-links/register';

 deprecate(
  () => {},
-  '@storybook/react/addons is deprecated. See https://storybooks.js.org/docs/react-storybook/addons/using-addons/'
+  '@storybook/react/addons is deprecated. See https://storybook.js.org/docs/react-storybook/addons/using-addons/'
 )();
--- a/app/react/demo/src/stories/Welcome.js
+++ b/app/react/demo/src/stories/Welcome.js
@ -97,7 +97,7 @@ export default class Welcome extends React.Component {
          {' '}
          <a
            style={styles.link}
-            href="https://storybooks.js.org/docs/react-storybook/basics/writing-stories"
+            href="https://storybook.js.org/docs/react-storybook/basics/writing-stories"
            target="_blank"
          >
            Writing Stories
--- a/docs/pages/addons/addon-gallery/index.md
+++ b/docs/pages/addons/addon-gallery/index.md
@ -7,8 +7,6 @@ This is a list of available addons for Storybook.

 ## Addons maintained by storybook team.

-These addons ship with Storybook by default. You can use them right away.
-
 ### [Actions](https://github.com/storybooks/storybook/tree/master/addons/actions)

 With actions, you can inspect events related to your components. This is pretty neat when you are manually testing your components.
@ -91,3 +89,7 @@ It is very useful if you are working on components that have to work both in LTR

 This addon shows a preview of the JSX code for each story.
 It allows you to configure the display and copy the code with a single click.
+
+### [Intl](https://github.com/truffls/storybook-addon-intl)
+
+With this addon you will have an additional panel at the bottom which provides you buttons to switch the locale and directly see the result in the preview.
--- a/examples/cra-storybook/src/stories/Welcome.js
+++ b/examples/cra-storybook/src/stories/Welcome.js
@ -97,7 +97,7 @@ export default class Welcome extends React.Component {
          {' '}
          <a
            style={styles.link}
-            href="https://storybooks.js.org/docs/react-storybook/basics/writing-stories"
+            href="https://storybook.js.org/docs/react-storybook/basics/writing-stories"
            target="_blank"
          >
            Writing Stories
--- a/examples/test-cra/src/snapshots/storyshots.test.js.snap
+++ b/examples/test-cra/src/snapshots/storyshots.test.js.snap
@ -170,7 +170,7 @@ exports[`Storyshots Welcome to Storybook 1`] = `
    Have a look at the
     
    <a
-      href="https://storybooks.js.org/docs/react-storybook/basics/writing-stories"
+      href="https://storybook.js.org/docs/react-storybook/basics/writing-stories"
      style={
        Object {
          "borderBottom": "1px solid #1474f3",
--- a/examples/test-cra/src/stories/Welcome.js
+++ b/examples/test-cra/src/stories/Welcome.js
@ -97,7 +97,7 @@ export default class Welcome extends React.Component {
          {' '}
          <a
            style={styles.link}
-            href="https://storybooks.js.org/docs/react-storybook/basics/writing-stories"
+            href="https://storybook.js.org/docs/react-storybook/basics/writing-stories"
            target="_blank"
          >
            Writing Stories
--- a/lib/addons/README.md
+++ b/lib/addons/README.md
@ -13,4 +13,4 @@ It stores addon loaders, communication channel and other resources which can be

 * * *

-For more information visit: [storybooks.js.org](https://storybooks.js.org)
+For more information visit: [storybook.js.org](https://storybook.js.org)
--- a/lib/channel-postmessage/README.md
+++ b/lib/channel-postmessage/README.md
@ -17,4 +17,4 @@ const channel = createChannel({ key: 'postmsg-key' })

 * * *

-For more information visit: [storybooks.js.org](https://storybooks.js.org)
+For more information visit: [storybook.js.org](https://storybook.js.org)
--- a/lib/channel-websocket/README.md
+++ b/lib/channel-websocket/README.md
@ -17,4 +17,4 @@ const channel = createChannel({ url: 'ws://localhost:9001' })

 * * *

-For more information visit: [storybooks.js.org](https://storybooks.js.org)
+For more information visit: [storybook.js.org](https://storybooks.js.org)
--- a/lib/channels/README.md
+++ b/lib/channels/README.md
@ -45,4 +45,4 @@ const channel = addons.getChannel();

 * * *

-For more information visit: [storybooks.js.org](https://storybooks.js.org)
+For more information visit: [storybook.js.org](https://storybook.js.org)
--- a/lib/cli/README.md
+++ b/lib/cli/README.md
@ -13,7 +13,7 @@ In the future it will also add other useful generators and migration tooling.

 ![Screenshot](docs/getstorybook.png)

-First install the storybook cli globally.
+First install the storybook CLI globally.

 ```sh
 npm i -g @storybook/cli
@ -40,4 +40,4 @@ If you don't want to use `yarn` always you can use the `--use-npm` option like t
 getstorybook --use-npm
 ```

-For more information visit: [storybooks.js.org](https://storybooks.js.org)
+For more information visit: [storybook.js.org](https://storybook.js.org)
--- a/lib/cli/bin/generate.js
+++ b/lib/cli/bin/generate.js
@ -55,7 +55,7 @@ const end = () => {

  logger.log('\nTo run your storybook, type:\n');
  codeLog([runStorybookCommand]);
-  logger.log('\nFor more information visit:', chalk.cyan('https://storybooks.js.org'));
+  logger.log('\nFor more information visit:', chalk.cyan('https://storybook.js.org'));

  // Add a new line for the clear visibility.
  logger.log();
@ -128,7 +128,7 @@ switch (projectType) {

  default:
    paddedLog(`Unsupported Project type. (code: ${projectType})`);
-    paddedLog('Visit https://storybooks.js.org for more information.');
+    paddedLog('Visit https://storybook.js.org for more information.');

    // Add a new line for the clear visibility.
    logger.log();
--- a/lib/cli/generators/REACT_SCRIPTS/template/src/stories/Welcome.js
+++ b/lib/cli/generators/REACT_SCRIPTS/template/src/stories/Welcome.js
@ -97,7 +97,7 @@ export default class Welcome extends React.Component {
          {' '}
          <a
            style={styles.link}
-            href="https://storybooks.js.org/docs/react-storybook/basics/writing-stories"
+            href="https://storybook.js.org/docs/react-storybook/basics/writing-stories"
            target="_blank"
          >
            Writing Stories
--- a/lib/cli/generators/WEBPACK_REACT/template/.storybook/webpack.config.js
+++ b/lib/cli/generators/WEBPACK_REACT/template/.storybook/webpack.config.js
@ -1,6 +1,6 @@
 // you can use this file to add your custom webpack plugins, loaders and anything you like.
 // This is just the basic way to add additional webpack configurations.
-// For more information refer the docs: https://storybooks.js.org/docs/react-storybook/configurations/custom-webpack-config
+// For more information refer the docs: https://storybook.js.org/docs/react-storybook/configurations/custom-webpack-config

 // IMPORTANT
 // When you add this file, we won't add the default configurations which is similar
--- a/lib/ui/README.md
+++ b/lib/ui/README.md
@ -7,7 +7,7 @@
 [![BCH compliance](https://bettercodehub.com/edge/badge/storybooks/storybook)](https://bettercodehub.com/results/storybooks/storybook) [![codecov](https://codecov.io/gh/storybooks/storybook/branch/master/graph/badge.svg)](https://codecov.io/gh/storybooks/storybook)
 [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

-Storybook UI the core UI of [storybook](https://storybooks.js.org).
+Storybook UI the core UI of [storybook](https://storybook.js.org).
 It's a React based UI which you can initialize with a simple function.
 You can configure it by providing a provider API.