Add a peerDependencies section in package.json documentation

Fixes #4739. Inspired by http://domenic.me/2013/02/08/peer-dependencies/. Ping @domenic.