Update listener-configuration.adoc

Author: JakeSCahill

modules/manage/pages/security/listener-configuration.adoc

@@ -34,7 +34,7 @@ redpanda:
 
 == Advertise a listener
 
-By default, the advertised address is the same as the bound address. For clients outside the local host or subnet, you must set an externally reachable address or hostname. Invalid settings—including `0.0.0.0`—will fail startup validation.
+By default, the advertised address is the same as the bound address. For clients outside the local host or subnet, you must set an externally reachable address or hostname. Invalid settings, including `0.0.0.0`, will fail startup validation.
 
 [source,yaml]
 ----
@@ -47,7 +47,7 @@ redpanda:
 [NOTE]
 ====
 * Use a valid hostname or IP. Do not use `0.0.0.0`.
-* When using a DNS hostname, ensure clients can resolve it and that it matches any TLS certificate SAN.
+* When using a DNS hostname, ensure that clients can resolve it and that it matches any TLS certificate Subject Alternative Name (SAN).
 ====
 
 == Multiple listeners
@@ -107,7 +107,7 @@ Ensure `kafka.example.com` matches the SAN in `broker.crt` and that clients trus
 
 == Mixed-mode authentication with multiple listeners
 
-Redpanda supports running multiple authentication schemes side by side. Each listener can specify its method, and must define a `name:`.
+Redpanda supports running multiple authentication schemes concurrently. Each listener can specify its method, and must define a `name` property.
 
 [source,yaml]
 ----
@@ -133,9 +133,23 @@ redpanda:
 
 == Listeners that can be advertised
 
-* `kafka_api` → `advertised_kafka_api`: Kafka clients connect here.
-* `rpc_server` → `advertised_rpc_api`: Other Redpanda brokers connect here.
-* `pandaproxy_api` → `advertised_pandaproxy_api`: HTTP clients connect here.
+[cols="1m,1m,2a"]
+|===
+| Listener | Advertised Listener | Description
+
+|kafka_api
+|advertised_kafka_api
+|Kafka clients connect here.
+
+|rpc_server
+|advertised_rpc_api
+|Other Redpanda brokers connect here.
+
+|pandaproxy_api
+|advertised_pandaproxy_api
+|HTTP proxy clients connect here.
+
+|===
 
-For each advertised block, match the `name:` of the corresponding listener and provide a valid address and port.
+For each advertised listener, match the `name` of the corresponding listener and provide a valid address and port.