docs: shorten CLI

docs/references/cli.rst

@@ -3,44 +3,49 @@
 CLI
 ===
 
-PostgREST provides a CLI to start and run your postgrest service. The CLI provides the commands listed below:
+PostgREST provides a CLI with the commands listed below:
 
-.. _cli_commands:
+Help
+----
 
-CLI Commands
-------------
+.. code:: bash
+
+ $ postgrest [-h|--help]
 
-Help and Version
-~~~~~~~~~~~~~~~~
+Shows all the commands available.
+
+Version
+-------
 
 .. code:: bash
 
- $ postgrest [-h|--help]
  $ postgrest [-v|--version]
 
-Example Config
-~~~~~~~~~~~~~~
+Prints the PostgREST version.
+
+Example
+-------
 
 .. code:: bash
 
  $ postgrest [-e|--example]
 
-These commands show the example configuration file.
+Shows example configuration options.
 
-Config
-~~~~~~
+Dump Config
+-----------
 
 .. code:: bash
 
- $ postgrest [--dump-config] [FILENAME]
+ $ postgrest [--dump-config]
 
-Here ``FILENAME`` is the path to configuration file.
+Dumps the loaded :ref:`configuration` values, considering the configuration file, environment variables and :ref:`in_db_config`.
 
-Schema Cache
-~~~~~~~~~~~~
+Dump Schema
+-----------
 
 .. code:: bash
 
- $ postgrest [--dump-schema] [FILENAME]
+ $ postgrest [--dump-schema]
 
-Here ``FILENAME`` is the path to configuration file.
+Dumps the schema cache in JSON format.