Dear doc guys,

Ambiguities

I find sentences such as

The mod_cluster offered as part of JBoss Web Server is used instead of a JBoss HTTP Connector client service for the worker node service.

mindbogglingly strange. I have no idea what message was the author trying to convey. Furthermore, descriptions such as:

The JBoss HTTP Connector mod-cluster uses Apache HTTP Server as the proxy server.

are vague and might be misleading for any uninitiated reader. mod_cluster is as simple as: Apache HTTP Server module (its load balancing, native part) and Tomcat listener (its load calculating, java part).

The mod_cluster connector has several advantages over mod_jk connector

The mod_cluster Management Protocol (MCMP) is an additional connection between the Tomcat servers and the Apache HTTP Server with the mod_cluster module enabled. It is used by the Tomcat servers to transmit server-side load figures and lifecycle events back to the Apache HTTP Server via a custom set of HTTP methods.

Dynamic configuration of Apache HTTP Server with mod_cluster allows Tomcat servers to join the load balancing arrangement without manual configuration.

Tomcat server performs the load calculations, rather than relying on the Apache HTTP Server with mod_cluster. This makes load balancing metrics more accurate than other connectors.

The mod_cluster connector gives fine-grained application lifecycle control. Each Tomcat server forwards web application context lifecycle events to the Apache HTTP Server, informing it to start or stop routing requests for a given context. This prevents end users from seeing HTTP errors due to unavailable resources.

AJP, HTTP or HTTPS transports can be used.