WIP

config/concepts/site.yaml

@@ -1,5 +1,5 @@
 name: site
-related_concepts: [network, link, platform]
+related_concepts: [link, network, platform, workload]
 description: |
   A site is a place on the [network](network.html) where application
   [workloads](workload.html) are running.  Sites are joined by

config/concepts/workload.yaml

@@ -1,9 +1,10 @@
 name: workload
-related_concepts: [site, connector, platform]
+related_concepts: [platform, site, connector]
 description: |
   A workload is a set of processes running on a
   [platform](platform.html).  A process is a pod, container, or system
-  process.
+  process.  Workloads in a [site](site.html) are exposed as services
+  on the [network](network.html) using [connectors](connector.html).
 
   <figure>
     <img src="images/workload-model.svg"/>

config/resources/router-access.yaml

@@ -3,7 +3,8 @@ related_resources: [Site, Link]
 links: [skupper/site_linking]
 description: |
   Configuration for secure access to the site router.  The
-  configuration includes TLS credentials and router ports.
+  configuration includes TLS credentials and router ports.  The
+  RouterAccess resource is used to implement link access for sites.
 metadata:
   include_properties: [metadata/*]
 spec:

input/concepts/site.md

@@ -5,12 +5,14 @@ refdog_object_links:
   url: /resources/site.html
 - title: Site command
   url: /commands/site/index.html
-- title: Network concept
-  url: /concepts/network.html
 - title: Link concept
   url: /concepts/link.html
+- title: Network concept
+  url: /concepts/network.html
 - title: Platform concept
   url: /concepts/platform.html
+- title: Workload concept
+  url: /concepts/workload.html
 ---
 
 # Site concept

input/concepts/workload.md

@@ -1,12 +1,12 @@
 ---
 body_class: object concept
 refdog_object_links:
+- title: Platform concept
+  url: /concepts/platform.html
 - title: Site concept
   url: /concepts/site.html
 - title: Connector concept
   url: /concepts/connector.html
-- title: Platform concept
-  url: /concepts/platform.html
 ---
 
 # Workload concept
@@ -15,7 +15,8 @@ refdog_object_links:
 
 A workload is a set of processes running on a
 [platform](platform.html).  A process is a pod, container, or system
-process.
+process.  Workloads in a [site](site.html) are exposed as services
+on the [network](network.html) using [connectors](connector.html).
 
 <figure>
   <img src="images/workload-model.svg"/>

input/resources/router-access.md

@@ -24,7 +24,8 @@ refdog_object_toc:
 <section>
 
 Configuration for secure access to the site router.  The
-configuration includes TLS credentials and router ports.
+configuration includes TLS credentials and router ports.  The
+RouterAccess resource is used to implement link access for sites.
 
 ~~~ yaml
 apiVersion: skupper.io/v2alpha1