WIP

config/commands.yaml

@@ -81,8 +81,7 @@ groups:
       - name: site
         description: |
           Display help for site commands and exit.
-
-          @resource_description@
+        inherit_standard_options: [help]
       - name: site create
         description: |
           Create a site.
@@ -173,6 +172,8 @@ groups:
     commands:
       - name: token
         resource: Claim
+        related_concepts: ["access grant", "access token"]
+        related_resources: [Grant, Claim]
         description: |
           Display help for token commands and exit.
         inherit_standard_options: [help]
@@ -237,8 +238,6 @@ groups:
         related_commands: [token]
         description: |
           Display help for link commands and exit.
-
-          @resource_description@
         inherit_standard_options: [help]
       - name: link create
         description: |
@@ -292,6 +291,7 @@ groups:
   - name: Service exposure
     commands:
       - name: connector
+        related_commands: [listener]
         description: |
           Display help for connector commands and exit.
         inherit_standard_options: [help]
@@ -405,6 +405,7 @@ groups:
           database   database      app=postgresql   -      5432   1
         inherit_standard_options: [output, namespace, context, platform, help]
       - name: listener
+        related_commands: [connector]
         description: |
           Display help for listener commands and exit.
         inherit_standard_options: [help]

config/concepts.yaml

@@ -46,8 +46,7 @@ groups:
           - XXX link cost
           - XXX only one direction needed
       - name: link access
-      - name: grant
-        rename: Access grant
+      - name: access grant
         links:
           - name: Access token concept
             url: /concepts/claim.html
@@ -59,8 +58,7 @@ groups:
           URL and secret code to obtain a certificate signed by the
           grant's certificate authority (CA), within a certain
           expiration window and for a limited number of redemptions.
-      - name: claim
-        rename: Access token
+      - name: access token
         links:
           - name: Access grant concept
             url: /concepts/grant.html

input/commands/connector-create.md

@@ -1,6 +1,12 @@
 ---
 body_class: command
 links:
+  - name: Connector concept
+    url: /concepts/connector.html
+  - name: Connector resource
+    url: /resources/connector.html
+  - name: Connector command
+    url: /commands/connector.html
   - name: Listener create command
     url: /commands/listener-create.html
 ---

input/commands/connector-delete.md

@@ -1,6 +1,12 @@
 ---
 body_class: command
 links:
+  - name: Connector concept
+    url: /concepts/connector.html
+  - name: Connector resource
+    url: /resources/connector.html
+  - name: Connector command
+    url: /commands/connector.html
   - name: Listener delete command
     url: /commands/listener-delete.html
 ---

input/commands/connector-status.md

@@ -1,5 +1,12 @@
 ---
 body_class: command
+links:
+  - name: Connector concept
+    url: /concepts/connector.html
+  - name: Connector resource
+    url: /resources/connector.html
+  - name: Connector command
+    url: /commands/connector.html
 ---
 
 # Connector status command

input/commands/connector-update.md

@@ -1,6 +1,12 @@
 ---
 body_class: command
 links:
+  - name: Connector concept
+    url: /concepts/connector.html
+  - name: Connector resource
+    url: /resources/connector.html
+  - name: Connector command
+    url: /commands/connector.html
   - name: Listener update command
     url: /commands/listener-update.html
 ---

input/commands/connector.md

@@ -5,6 +5,8 @@ links:
     url: /concepts/connector.html
   - name: Connector resource
     url: /resources/connector.html
+  - name: Listener command
+    url: /commands/listener.html
 ---
 
 # Connector command

input/commands/debug-dump.md

@@ -1,5 +1,8 @@
 ---
 body_class: command
+links:
+  - name: Debug command
+    url: /commands/debug.html
 ---
 
 # Debug dump command

input/commands/link-create.md

@@ -1,5 +1,12 @@
 ---
 body_class: command
+links:
+  - name: Link concept
+    url: /concepts/link.html
+  - name: Link resource
+    url: /resources/link.html
+  - name: Link command
+    url: /commands/link.html
 ---
 
 # Link create command

input/commands/link-delete.md

@@ -1,5 +1,12 @@
 ---
 body_class: command
+links:
+  - name: Link concept
+    url: /concepts/link.html
+  - name: Link resource
+    url: /resources/link.html
+  - name: Link command
+    url: /commands/link.html
 ---
 
 # Link delete command

input/commands/link-status.md

@@ -1,5 +1,12 @@
 ---
 body_class: command
+links:
+  - name: Link concept
+    url: /concepts/link.html
+  - name: Link resource
+    url: /resources/link.html
+  - name: Link command
+    url: /commands/link.html
 ---
 
 # Link status command

input/commands/link-update.md

@@ -1,5 +1,12 @@
 ---
 body_class: command
+links:
+  - name: Link concept
+    url: /concepts/link.html
+  - name: Link resource
+    url: /resources/link.html
+  - name: Link command
+    url: /commands/link.html
 ---
 
 # Link update command

input/commands/link.md

@@ -15,13 +15,6 @@ links:
 
 Display help for link commands and exit.
 
-A site-to-site communication channel. Links serve as a
-transport for application connections and requests.  A set
-of linked sites constitute a network.
-
-Links are not usually created directly.  Instead, you
-typically use an access token to obtain a link.
-
 </section>
 
 <section>

input/commands/listener-create.md

@@ -1,6 +1,12 @@
 ---
 body_class: command
 links:
+  - name: Listener concept
+    url: /concepts/listener.html
+  - name: Listener resource
+    url: /resources/listener.html
+  - name: Listener command
+    url: /commands/listener.html
   - name: Connector create command
     url: /commands/connector-create.html
 ---

input/commands/listener-delete.md

@@ -1,6 +1,12 @@
 ---
 body_class: command
 links:
+  - name: Listener concept
+    url: /concepts/listener.html
+  - name: Listener resource
+    url: /resources/listener.html
+  - name: Listener command
+    url: /commands/listener.html
   - name: Connector delete command
     url: /commands/connector-delete.html
 ---

input/commands/listener-status.md

@@ -1,5 +1,12 @@
 ---
 body_class: command
+links:
+  - name: Listener concept
+    url: /concepts/listener.html
+  - name: Listener resource
+    url: /resources/listener.html
+  - name: Listener command
+    url: /commands/listener.html
 ---
 
 # Listener status command

input/commands/listener-update.md

@@ -1,6 +1,12 @@
 ---
 body_class: command
 links:
+  - name: Listener concept
+    url: /concepts/listener.html
+  - name: Listener resource
+    url: /resources/listener.html
+  - name: Listener command
+    url: /commands/listener.html
   - name: Connector update command
     url: /commands/connector-update.html
 ---

input/commands/listener.md

@@ -5,6 +5,8 @@ links:
     url: /concepts/listener.html
   - name: Listener resource
     url: /resources/listener.html
+  - name: Connector command
+    url: /commands/connector.html
 ---
 
 # Listener command

input/commands/site-create.md

@@ -1,5 +1,12 @@
 ---
 body_class: command
+links:
+  - name: Site concept
+    url: /concepts/site.html
+  - name: Site resource
+    url: /resources/site.html
+  - name: Site command
+    url: /commands/site.html
 ---
 
 # Site create command

input/commands/site-delete.md

@@ -1,5 +1,12 @@
 ---
 body_class: command
+links:
+  - name: Site concept
+    url: /concepts/site.html
+  - name: Site resource
+    url: /resources/site.html
+  - name: Site command
+    url: /commands/site.html
 ---
 
 # Site delete command

input/commands/site-status.md

@@ -1,5 +1,12 @@
 ---
 body_class: command
+links:
+  - name: Site concept
+    url: /concepts/site.html
+  - name: Site resource
+    url: /resources/site.html
+  - name: Site command
+    url: /commands/site.html
 ---
 
 # Site status command

input/commands/site-update.md

@@ -1,5 +1,12 @@
 ---
 body_class: command
+links:
+  - name: Site concept
+    url: /concepts/site.html
+  - name: Site resource
+    url: /resources/site.html
+  - name: Site command
+    url: /commands/site.html
 ---
 
 # Site update command

input/commands/site.md

@@ -13,9 +13,18 @@ links:
 
 Display help for site commands and exit.
 
-A place where components of your application are running.
-Sites are linked to form application networks.
+</section>
+
+<section>
+
+## Options
+
+- <h3 id="help">--help <span class="option-info"></span></h3>
 
-There can be only one site resource per namespace.
+  Display help and exit.
 
+  | | |
+  |-|-|
+  | Platforms | Kubernetes, Docker |
+
 </section>

input/commands/token-issue.md

@@ -1,6 +1,8 @@
 ---
 body_class: command
 links:
+  - name: Token command
+    url: /commands/token.html
   - name: Token redeem command
     url: /commands/token-redeem.html
 ---

input/commands/token-redeem.md

@@ -1,6 +1,8 @@
 ---
 body_class: command
 links:
+  - name: Token command
+    url: /commands/token.html
   - name: Token issue command
     url: /commands/token-issue.html
 ---

input/commands/token.md

@@ -1,5 +1,14 @@
 ---
 body_class: command
+links:
+  - name: Access grant concept
+    url: /concepts/access-grant.html
+  - name: Access token concept
+    url: /concepts/access-token.html
+  - name: AccessGrant resource
+    url: /resources/grant.html
+  - name: AccessToken resource
+    url: /resources/claim.html
 ---
 
 # Token command

input/concepts/access-grant.md

@@ -0,0 +1,20 @@
+---
+body_class: concept
+links:
+  - name: Access token concept
+    url: /concepts/claim.html
+  - name: Token issue command
+    url: /commands/token-issue.html
+---
+
+# Access grant concept
+
+<section>
+
+Permission to redeem access tokens for links to the local
+site.  A remote site can use a token containing the grant
+URL and secret code to obtain a certificate signed by the
+grant's certificate authority (CA), within a certain
+expiration window and for a limited number of redemptions.
+
+</section>