diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7a9fd99bb4e6..11a8150cc5b1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -15,18 +15,12 @@ Plus many more features, documentation improvements, and bugfixes below!
- Vue support [#1267](https://github.com/storybooks/storybook/pull/1267)
- Add support for vue in addon-notes [#1278](https://github.com/storybooks/storybook/pull/1278)
- CLI support for Vue [#1287](https://github.com/storybooks/storybook/pull/1287)
-
-
- Story Hierarchy [#1329](https://github.com/storybooks/storybook/pull/1329)
- Story Hierarchy UI improvements [#1387](https://github.com/storybooks/storybook/pull/1387) [#1356](https://github.com/storybooks/storybook/pull/1356)
- Story Hierarchy - keyboard accessibility [#1427](https://github.com/storybooks/storybook/pull/1427)
-
-
- React Native - On Device UI [#1413](https://github.com/storybooks/storybook/pull/1413)
- Show first story on RN OnDeviceUI startup [#1510](https://github.com/storybooks/storybook/pull/1510)
- Added collapsible RN OnDeviceUI navigation [#1544](https://github.com/storybooks/storybook/pull/1544)
-
-
- Add warning when module is missing in storiesOf [#1525](https://github.com/storybooks/storybook/pull/1525)
- Provide styling hook for Addon Info story body [#1308](https://github.com/storybooks/storybook/pull/1308)
- Implement filtering on story-level [#1432](https://github.com/storybooks/storybook/pull/1432)
diff --git a/docs/pages/basics/faq/index.md b/docs/pages/basics/faq/index.md
index d4a78ba32b54..a929eb634cab 100644
--- a/docs/pages/basics/faq/index.md
+++ b/docs/pages/basics/faq/index.md
@@ -1,7 +1,8 @@
----
+* * *
+
id: 'faq'
-title: 'Frequently Asked Questions'
----
+
+## title: 'Frequently Asked Questions'
Here are some answers to frequently asked questions. If you have a question, you can ask it by opening an issue on the [Storybook Repository](https://github.com/storybooks/storybook/).
@@ -29,3 +30,27 @@ You can generally reuse webpack rules fairly easily by placing them in a file th
A common error is that an addon tries to access the "channel", but the channel is not set. This can happen in a few different cases:
1. In storybook/addon development, it can be an NPM version problem. If there are two versions of the addons NPM package, it will cause problems. In this case, make sure there is only a single version of `@storybook/addons` being used by your project.
2. In React Native, it's a special case that's documented in [#1192](https://github.com/storybooks/storybook/issues/1192)
+
+### Can I modify React component state in stories?
+
+Not directly. If you control the component source, you can do something like this:
+
+```js
+import React, { Component} from 'react';
+import { storiesOf } from '@storybook/react';
+
+class MyComponent extends Component {
+ constructor(props) {
+ super(props)
+ this.setState({
+ someVar: 'defaultValue',
+ ...props.initialState
+ })
+ }
+ // ...
+}
+
+storiesOf('MyComponent', module)
+ .add('default', () => )
+ .add('other', () =>