Rewrite peer_handler module documentation

[jkczyz]

The documentation assumes the audience understands how socket descriptors are used by PeerManager. It should be re-written to describe these concepts including the interaction with ChannelManager and Router (e.g., how data flows, events are generated, messages are sent/received) along with an example.