Improved router documentation. Fixes #2874
  * Edit of basic usage and design.
  * Rearranged order of sections.
  * Added more information on special message types.