[GitHub] [qpid-dispatch] bhardesty opened a new pull request #512: DISPATCH-1338: Restructure Dispatch Router book for edge router

[GitBox <gi...@apache.org>]

bhardesty opened a new pull request #512: DISPATCH-1338: Restructure Dispatch Router book for edge router
URL: https://github.com/apache/qpid-dispatch/pull/512
 
 
   The Dispatch Router user guide, as currently structured, describes how to configure and manage a (single) router. This is problematic given that Dispatch Router is intended to be deployed in networks of (many) routers. The introduction of "edge" mode complicated this issue. To resolve this, I have added content for configuring the router network topology, and separated it from the routing configuration (since one of the fundamental design principles of Dispatch Router is that the routing is independent from the underlying network topology).
   
   This results, roughly, in a new book structure that looks something like this (kind of hard to see from inspecting the zillions of changed files in the PR):
   * Overview
   * Getting started
   * Configuring a router network topology (new; edge router fits in here)
   * Routing messages through the router network
   * Monitoring and managing the router network
   
   The new "Configuring a router network topology" chapter mostly consists of existing content that's been refactored into modular procedures that fit the overall context of building a network of routers.
   
   The authorization, routing, and management content has been moved to fit the new overall structure, but has not been refactored into assemblies/modules. Those improvements will be handled in separate PRs.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@qpid.apache.org
For additional commands, e-mail: dev-help@qpid.apache.org