Confusing documentation about react-redux

[mindjuice]

Try to only do this for a top-level component

Notice it says "a" top-level component, not "the" top-level component. You can, and probably should, connect() multiple times for top-level components (e.g., header, sidebar, main content, footer). You could make the argument that choosing the route handler would be "the" top-level though.

In my opinion, more calls to connect() doesn't actually make the data harder to trace, but easier. I can see immediately where the data is coming from in a connect()ed component rather than tracing it up through props.

The downside though, is that it ties a component to a given app, because the component needs to know the shape of the state object. If you don't want to reuse the code though, then that's not really a downside.

It's generally better to have a handful of "smart" components that know about the app, and have them rely on "dumb" components that render entirely from props.

If you're not using it already, look into reselect too. They are about to go 1.0.

You may also be able to take advantage of React's PureRenderMixin to restrict how deep the re-rendering goes.

[gnoff]

@arkwright I believe you are slightly misinterpreting the point of the the readme where is says

Don’t do this! It kills any performance optimisations because TodoApp will rerender after every action.

The example is showing an connect select function that maps the entire state to the connected component

export default connect(state => state)(TodoApp);

In any application of reasonable size this is likely unnecessary since parts of your state are likely not of concern for the given connected component. The point about performance is recognizing that in this given example the component will be re-rendered anytime any state changes even if it isn't relevant to the connected component.

I think the readme example could probably make this a little more clear so that future readers don't also come away with the impression you did.

Hopefully that helps clear things up.

Thanks,
Josh

[gaearon]

👍