[GitHub] [qpid-dispatch] jbyrne-redhat commented on a change in pull request #516: DISPATCH-1347: Update doc for setting up and accessing web console

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

jbyrne-redhat commented on a change in pull request #516: DISPATCH-1347: Update doc for setting up and accessing web console
URL: https://github.com/apache/qpid-dispatch/pull/516#discussion_r289303385
 
 

 ##########
 File path: docs/books/user-guide/using-console.adoc
 ##########
 @@ -17,110 +17,100 @@ specific language governing permissions and limitations
 under the License
 ////
 
+[id='using-router-console']
 = Using {ConsoleName}
 
-[[console-overview]]
-== Console Overview
+{ConsoleName} is a web console for monitoring the status and performance of {RouterName} router networks.
 
-The console is an HTML based web site that displays information about a qpid dispatch router network.
+== Setting up access to the web console
 
-The console requires an HTML web server that can serve static html, javascript, style sheets, and images.
+Before you can access the web console, you must configure a `listener` to accept HTTP connections for the web console and serve the console files.
 
-The console only provides limited information about the clients that are attached to the router network and is therfore more appropriate for administrators needing to know the layout and health of the router network.
+.Procedure
 
-[[console-installation]]
-== Console Installation
+. On the router from which you want to access the web console, open the {RouterConfigFile} configuration file.
 
 Review comment:
   {RouterConfigFile} is unresolved in the HTML. Is this a new alias?

----------------------------------------------------------------
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