Improved router documentation. Fixes #2874

  * Revampled design section.
  * Revamped description of Broadcast messages.
  * Added description of PoisonPill message.
  * A few other minor doc edits.

More routing doc work