Update live reference docs (#1902)

* Update live reference docs * Addressed comments * Addressed comments
kptdev · May 6, 2021 · 87c72d6 · 87c72d6
1 parent edd0a1b
commit 87c72d6
Show file tree

Hide file tree

Showing 9 changed files with 293 additions and 648 deletions.
diff --git a/site/reference/TEMPLATE.md b/site/reference/TEMPLATE.md
@@ -14,6 +14,7 @@ not be capitalized, for example `get`, `update`, `fn`.
 The documentation for each command should be focused and concise. Any fundamental
 concepts or concerns cutting across many command should be covered in the kpt book
 and the reference docs should provide deep links to the relevant content.
+Args, flags, and env vars should be listed in alphabetical order.
 
 ### Synopsis
 <!--mdtogo:Long-->

diff --git a/site/reference/live/README.md b/site/reference/live/README.md
@@ -1,5 +1,5 @@
 ---
-title: "Live"
+title: "`live`"
 linkTitle: "live"
 weight: 3
 type: docs
@@ -10,14 +10,7 @@ description: >
     Reconcile configuration files with the live state
 -->
 
-{{< asciinema key="live" rows="10" preload="1" >}}
-
 <!--mdtogo:Long-->
-| Reads From              | Writes To                |
-|-------------------------|--------------------------|
-| local files             | cluster                  |
-| cluster                 | stdout                   |
-
-Live contains the next-generation versions of apply related commands for
-deploying local configuration packages to a cluster.
+`live` contains functionality for deploying local configuration
+packages to a cluster.
 <!--mdtogo-->