Update CLI docs (#322)

* Update CLI docs

* fix md error

* typo

* minor edit

Author: alexandratran

docs/Reference/CLI/CLI-Syntax.md

@@ -4,40 +4,50 @@ description: Teku command line interface reference
 
 # Teku command line
 
-This reference describes the syntax of the Teku Command Line Interface (CLI) options and subcommands.
+This reference describes the syntax of the Teku command line interface (CLI) options.
 
 !!! important
-    The command line interface options are currently under development and may change.
+
+    The CLI options are currently under development and may change.
 
 ## Specifying options
 
-Teku options can be specified:
+You can specify Teku options:
+
+* On the command line.
+  
+    ```bash
+    teku [OPTIONS] [COMMAND]
+    ```
+
+* As an environment variable.
+  For each command line option, the equivalent environment variable is:
+
+    * Uppercase.
+    * `-` is replaced by `_`.
+    * Has a `TEKU_` prefix.
 
-* On the command line
-* As an [environment variable](#teku-environment-variables)
 * In a [YAML configuration file](../../HowTo/Configure/Use-Configuration-File.md).
 
 If an option is specified in multiple places, the order of priority is command line, environment variable,
 configuration file.
 
-### Teku environment variables
-
-For each command line option, the equivalent environment variable is:
+## Using autocomplete
 
-* Upper-case
-* `-` is replaced by `_`
-* Has a `TEKU_` prefix
+If using Bash or Z shell, you can enable autocomplete support by navigating to the `build` folder and running:
 
-For example, set `--p2p-port` using the `TEKU_P2P_PORT` environment variable.
-
-## Options
+```bash
+source teku.autocomplete.sh
+```
 
-To start a Teku beacon chain client and validator run:
+Autocomplete allows you to view option suggestions by entering `--` and pressing the Tab key twice.
 
 ```bash
-teku [OPTIONS] [COMMAND]
+teku --Tab+Tab
 ```
 
+## Options
+
 ### config-file
 
 === "Syntax"

docs/Reference/CLI/Subcommands/Admin.md

@@ -4,13 +4,7 @@ title: Subcommand options
 
 # `admin`
 
-Used to perform administrative tasks. To use the `admin` subcommand run:
-
-```bash
-teku admin [subcommand] [subcommand] [options]
-```
-
-You can also supply the subcommand options using [environment variables or a configuration file].
+Used to perform administrative tasks.
 
 ## `weak-subjectivity`
 
@@ -20,7 +14,7 @@ Display or clear weak subjectivity configuration.
 
 Clears the stored weak subjectivity configuration.
 
-#### config-file
+#### `config-file`
 
 === "Syntax"
 
@@ -43,7 +37,7 @@ Clears the stored weak subjectivity configuration.
 Path to the YAML configuration file.
 The default is `none`.
 
-#### data-base-path, data-path
+#### `data-base-path`, `data-path`
 
 === "Syntax"
 
@@ -77,7 +71,7 @@ Path to the Teku data directory. The default directory is OS-dependent:
 
 The default Docker image location is `/root/.local/share/teku`.
 
-#### data-beacon-path
+#### `data-beacon-path`
 
 === "Syntax"
 
@@ -106,7 +100,7 @@ The default Docker image location is `/root/.local/share/teku`.
 Path to the beacon chain client data. The default is `<data-base-path>/beacon` where `<data-base-path>`
 is specified using [`--data-base-path`](#data-base-path-data-path).
 
-#### data-storage-archive-frequency
+#### `data-storage-archive-frequency`
 
 === "Syntax"
 
@@ -147,7 +141,7 @@ This option is ignored if [`--data-storage-mode`](#data-storage-mode) is set to
     `--data-storage-archive-frequency=2048` uses less disk space, but may need to regenerate the
     state because every 2048th slot state is saved.
 
-#### data-storage-mode
+#### `data-storage-mode`
 
 === "Syntax"
 
@@ -176,7 +170,7 @@ This option is ignored if [`--data-storage-mode`](#data-storage-mode) is set to
 Set the strategy for handling historical chain data. Valid options are `prune` and `archive`.
 The default is `prune`.
 
-#### data-validator-path
+#### `data-validator-path`
 
 === "Syntax"
 
@@ -205,7 +199,7 @@ The default is `prune`.
 Path to the validator client data. The default is `<data-base-path>/validator` where `<data-base-path>`
 is specified using [`--data-base-path`](#data-base-path-data-path).
 
-#### eth1-deposit-contract-address
+#### `eth1-deposit-contract-address`
 
 === "Syntax"
 
@@ -233,7 +227,7 @@ is specified using [`--data-base-path`](#data-base-path-data-path).
 
 Ethereum 1.0 address of the deposit contract. Only required when creating a custom network.
 
-#### network
+#### `network`
 
 === "Syntax"
 
@@ -278,7 +272,7 @@ bootnodes, and the address of the Ethereum 1.0 deposit contract.
 
 Displays the stored weak subjectivity configuration.
 
-#### config-file
+#### `config-file`
 
 === "Syntax"
 
@@ -301,7 +295,7 @@ Displays the stored weak subjectivity configuration.
 Path to the YAML configuration file.
 The default is `none`.
 
-#### data-base-path, data-path
+#### `data-base-path`, `data-path`
 
 === "Syntax"
 
@@ -335,7 +329,7 @@ Path to the Teku data directory. The default directory is OS-dependent:
 
 The default Docker image location is `/root/.local/share/teku`.
 
-#### data-beacon-path
+#### `data-beacon-path`
 
 === "Syntax"
 
@@ -364,7 +358,7 @@ The default Docker image location is `/root/.local/share/teku`.
 Path to the beacon chain client data. The default is `<data-base-path>/beacon` where `<data-base-path>`
 is specified using [`--data-base-path`](#data-base-path-data-path).
 
-#### data-storage-archive-frequency
+#### `data-storage-archive-frequency`
 
 === "Syntax"
 
@@ -405,7 +399,7 @@ This option is ignored if [`--data-storage-mode`](#data-storage-mode) is set to
     `--data-storage-archive-frequency=2048` uses less disk space, but may need to regenerate the
     state because every 2048th slot state is saved.
 
-#### data-storage-mode
+#### `data-storage-mode`
 
 === "Syntax"
 
@@ -434,7 +428,7 @@ This option is ignored if [`--data-storage-mode`](#data-storage-mode) is set to
 Set the strategy for handling historical chain data. Valid options are `prune` and `archive`.
 The default is `prune`.
 
-#### data-validator-path
+#### `data-validator-path`
 
 === "Syntax"
 
@@ -463,7 +457,7 @@ The default is `prune`.
 Path to the validator client data. The default is `<data-base-path>/validator` where `<data-base-path>`
 is specified using [`--data-base-path`](#data-base-path-data-path).
 
-#### eth1-deposit-contract-address
+#### `eth1-deposit-contract-address`
 
 === "Syntax"
 
@@ -491,7 +485,7 @@ is specified using [`--data-base-path`](#data-base-path-data-path).
 
 Ethereum 1.0 address of the deposit contract. Only required when creating a custom network.
 
-#### network
+#### `network`
 
 === "Syntax"
 
@@ -530,6 +524,3 @@ Possible values are:
 
 Predefined networks can provide defaults such the initial state of the network,
 bootnodes, and the address of the Ethereum 1.0 deposit contract.
-
-<!-- link -->
-[environment variables or a configuration file]: ../CLI-Syntax.md#specifying-options

docs/Reference/CLI/Subcommands/Development.md

@@ -10,14 +10,26 @@ The following subcommands are used for development and testing purposes.
 
 Manually run state transitions for blocks or slots for debugging.
 
+```bash
+teku transtion
+```
+
 ## `peer`
 
-Commands to generate a list of peer IDs, including the private key, public key, and peer ID.
+Generate a list of peer IDs, including the private key, public key, and peer ID.
+
+```bash
+teku peer
+```
 
 ## `genesis`
 
 Generate a genesis state for a network.
 
+```bash
+teku genesis
+```
+
 <!-- links -->
 [environment variables]: CLI-Syntax.md##teku-environment-variables
 [configuration file]: ../../HowTo/Configure/Use-Configuration-File.md

docs/Reference/CLI/Subcommands/Migrate-Database.md

@@ -11,18 +11,18 @@ title: Database migration subcommand options
     As of v21.5.0, new Teku installations use a LevelDB2 database. Previous Teku versions use
     RocksDB which continue to be supported.
 
-## config-file
+## `config-file`
 
 === "Syntax"
 
     ```bash
-    --config-file=<FILE>
+    teku migrate-database --config-file=<FILE>
     ```
 
 === "Example"
 
     ```bash
-    --config-file=/home/me/me_node/config.yaml
+    teku migrate-database --config-file=/home/me/me_node/config.yaml
     ```
 
 === "Environment variable"
@@ -34,18 +34,18 @@ title: Database migration subcommand options
 Path to the [YAML configuration file](../../../HowTo/Configure/Use-Configuration-File.md).
 The default is `none`.
 
-## data-base-path, data-path
+## `data-base-path`, `data-path`
 
 === "Syntax"
 
     ```bash
-    --data-base-path=<PATH>
+    teku migrate-database --data-base-path=<PATH>
     ```
 
 === "Example"
 
     ```bash
-    --data-base-path=/home/me/me_node
+    teku migrate-database --data-base-path=/home/me/me_node
     ```
 
 === "Environment variable"
@@ -68,18 +68,18 @@ Path to the Teku data directory. The default directory is OS-dependent:
 
 The default Docker image location is `/root/.local/share/teku`.
 
-## data-beacon-path
+## `data-beacon-path`
 
 === "Syntax"
 
     ```bash
-    --data-beacon-path=<PATH>
+    teku migrate-database --data-beacon-path=<PATH>
     ```
 
 === "Example"
 
     ```bash
-    --data-beacon-path=/home/me/me_node
+    teku migrate-database --data-beacon-path=/home/me/me_node
     ```
 
 === "Environment variable"
@@ -97,18 +97,18 @@ The default Docker image location is `/root/.local/share/teku`.
 Path to the beacon chain client data. The default is `<data-base-path>/beacon` where `<data-base-path>`
 is specified using [`--data-base-path`](#data-base-path-data-path).
 
-## network
+## `network`
 
 === "Syntax"
 
     ```bash
-    --network=<NETWORK>
+    teku migrate-database --network=<NETWORK>
     ```
 
 === "Example"
 
     ```bash
-    --network=mainnet
+    teku migrate-database --network=mainnet
     ```
 
 === "Environment variable"