WIP

config/resources/link.yaml

@@ -6,10 +6,10 @@ description: |
   Links carry application connections and requests.  A set of linked
   sites constitutes a network.
 
-  A Link resource has remote connection endpoints and TLS credentials
-  for establishing a mutual TLS connection to a remote site.  To
-  create an active link, the remote site must first enable _link
-  access_.  Link access provides an external access point for
+  A Link resource specifies remote connection endpoints and TLS
+  credentials for establishing a mutual TLS connection to a remote
+  site.  To create an active link, the remote site must first enable
+  _link access_.  Link access provides an external access point for
   accepting links.
 
   **Note:** Links are not usually created directly.  Instead, you can

config/resources/listener.yaml

@@ -6,9 +6,9 @@ description: |
   [connectors](connector.html) in remote [sites](site.html).
   Listeners and connectors are matched by routing key.
 
-  A Listener resource has a host and port for accepting connections
-  from local clients.  To expose a multi-port service, create multiple
-  listeners with the same host value.
+  A Listener resource specifies a host and port for accepting
+  connections from local clients.  To expose a multi-port service,
+  create multiple listeners with the same host value.
 examples:
   - description: |
       A listener in site West for the Hello World backend service

input/resources/link.md

@@ -18,10 +18,10 @@ A link is a channel for communication between [sites](site.html).
 Links carry application connections and requests.  A set of linked
 sites constitutes a network.
 
-A Link resource has remote connection endpoints and TLS credentials
-for establishing a mutual TLS connection to a remote site.  To
-create an active link, the remote site must first enable _link
-access_.  Link access provides an external access point for
+A Link resource specifies remote connection endpoints and TLS
+credentials for establishing a mutual TLS connection to a remote
+site.  To create an active link, the remote site must first enable
+_link access_.  Link access provides an external access point for
 accepting links.
 
 **Note:** Links are not usually created directly.  Instead, you can

input/resources/listener.md

@@ -18,9 +18,9 @@ A listener binds a local connection endpoint to
 [connectors](connector.html) in remote [sites](site.html).
 Listeners and connectors are matched by routing key.
 
-A Listener resource has a host and port for accepting connections
-from local clients.  To expose a multi-port service, create multiple
-listeners with the same host value.
+A Listener resource specifies a host and port for accepting
+connections from local clients.  To expose a multi-port service,
+create multiple listeners with the same host value.
 
 ~~~ yaml
 apiVersion: skupper.io/v2alpha1