fix(docs): remove mapDispatchToProps invalid use case

[unrevised6419]

Tried every form of mapDispatchToProps
dispatch is never missing from props

[netlify]

Deploy preview for react-redux-docs ready!

Built with commit dc2c1b8

https://deploy-preview-1364--react-redux-docs.netlify.com

[timdorr]

Yep, that's out of date. Thanks!

[markerikson]

Uh.... wait, what? No, we don't pass dispatch in if you do mapDispatch. We never have.

[markerikson]

See the current implementation here:

react-redux/src/connect/mapDispatchToProps.js

Lines 4 to 22 in ae6f033

	export function whenMapDispatchToPropsIsFunction(mapDispatchToProps) {
	return typeof mapDispatchToProps === 'function'
	? wrapMapToPropsFunc(mapDispatchToProps, 'mapDispatchToProps')
	: undefined
	}
	export function whenMapDispatchToPropsIsMissing(mapDispatchToProps) {
	return !mapDispatchToProps
	? wrapMapToPropsConstant(dispatch => ({ dispatch }))
	: undefined
	}
	export function whenMapDispatchToPropsIsObject(mapDispatchToProps) {
	return mapDispatchToProps && typeof mapDispatchToProps === 'object'
	? wrapMapToPropsConstant(dispatch =>
	bindActionCreators(mapDispatchToProps, dispatch)
	)
	: undefined
	}

We return the result of mapDispatch(dispatch) if it's a function, the result of bindActionCreators(mapDispatch, dispatch) if it's an object, and () => {dispatch} if it's missing.

The existing docs were correct. Reverting.

[unrevised6419]

Hmm, my bad, it seems another HOC is injecting dispatch.
https://codesandbox.io/s/awesome-thompson-l45q2

[timdorr]

Whoops, my bad for merging without thinking too hard!