docs: Reorganize documentation for better readability (#179)

# Reorganize Documentation

## Description
This PR reorganizes the FIREWHEEL documentation to clean up the
documentation side bar and ensure all documentation is located with
related documentation. This will make extending the documentation
significantly easier in the future and enable easier location of needed
docs.

## Type of Change
Please select the type of change your pull request introduces:
- [ ] Bugfix
- [ ] New feature
- [x] Documentation update
- [ ] Other (please describe):

## Checklist
- [x] This PR conforms to the process detailed in the [Contributing
Guide](https://sandialabs.github.io/firewheel/developer/contributing.html).
- [x] I have included no proprietary/sensitive information in my code. 
- [x] I have performed a self-review of my code.
- [x] I have commented my code, particularly in hard-to-understand
areas.
- [x] I have made corresponding changes to the documentation.
- [x] My changes generate no new warnings.
- [x] I have tested my code.

## Additional Notes
Documentation was primarily moved and the content was not significantly
changed. Mostly grammar/spelling/clarity was addressed.

---------

Signed-off-by: Steven Elliott <[email protected]>
Co-authored-by: Mitch Negus <[email protected]>

Author: sdelliot

docs/source/FIREWHEEL_Cheat_Sheet_final.pdf renamed to docs/source/_static/FIREWHEEL_Cheat_Sheet_final.pdf

@@ -0,0 +1,8 @@
+*********************
+FIREWHEEL Cheat Sheet
+*********************
+
+.. raw:: html
+
+    <p>You can download the cheat sheet here: <a href="_static/FIREWHEEL_Cheat_Sheet_final.pdf" target="_blank">FIREWHEEL Cheat Sheet</a></p>
+

docs/source/cheat_sheet.rst

@@ -4,22 +4,64 @@
 Command Line Interface
 ######################
 
-The FIREWHEEL Command Line Interface (CLI) allows interaction with and management of FIREWHEEL.
-The CLI (:py:mod:`cli/firewheel_cli.py <firewheel.cli.firewheel_cli>`) uses Python's
-:py:mod:`cmd` module.
-However, there is one notable difference: the CLI is designed to work with a FIREWHEEL cluster which means that commands may need to be executed on one or many hosts.
-To accomplish this, the CLI has been extended with :ref:`cli_helper_section`.
-:ref:`cli_helper_section` do not use the standard `Cmd <https://docs.python.org/3/library/cmd.html>`_ format, but they enable us to use Python and Shell scripting to perform various actions across the cluster (see :ref:`cli_executors`).
-The CLI automatically distributes Helpers to enable performing actions over the entire cluster.
-Therefore, the CLI may be accessed from any node in the cluster.
-The distinction between commands and Helpers is not relevant for most users so we will use these terms interchangeably.
-CLI commands may output error message to the screen, but remote commands will indicate an error through a non-zero exit code.
+Once the Python virtual environment is active, the CLI can be accessed by using the command ``firewheel`` in your terminal or directly using :exc:`firewheel_cli.py <firewheel.cli.firewheel_cli>`.
+This will open up the CLI in "interactive" mode which looks like:
+
+.. code-block:: bash
+
+    $ firewheel
+    FIREWHEEL Infrastructure CLI
+    fw-cli>
+
+The CLI also supports single-command execution (or non-interactive mode).
+This is the most common use of the CLI.
+Running the CLI with arguments results in those arguments being treated as a single entered command (and associated arguments).
+For example, the following examples are equivalent:
+
+.. code-block:: bash
+
+    $ firewheel vm mix
+
+.. code-block:: bash
+
+    fw-cli> vm mix
+
+Helpers can be invoked by name as a command or using the :ref:`command_run` command.
+
+.. code-block:: bash
+
+    fw-cli> run vm mix
+
+While it is most common that users will invoke a Helper via its name, using the :ref:`command_run` command also disambiguates a Helper's name from built-in command names.
+Additionally in interactive mode, the :ref:`command_run` command provides the ability to tab-complete Helpers.
+
+Available Helpers can be enumerated using the :ref:`command_list` or :ref:`command_help` commands or they can found here: :ref:`cli_helpers`.
+
+For complete help on any command, use: ``firewheel help <command | Helper>``.
+
+Some commands may take arguments.
+Everything on the command line after the name of the command is treated as an argument to that command.
+Some commands use `Argparse <https://docs.python.org/3/library/argparse.html>`_ to handle arguments.
+In this case, using ``-h`` or ``--help`` flag may also work.
+However, this information *should* also be available by using: ``firewheel help <command | Helper>``.
+
+All CLI commands *should* report success/failure via the exit code.
+Many commands also output useful information directly to the screen.
+For example:
+
+.. code-block:: bash
+
+    $ firewheel repository list
+    Installed Model Component Repositories:
+    /opt/firewheel/model_components
+
+As with other FIREWHEEL components, the CLI logs to ``firewheel.log``.
+However, because the CLI is verbose, it has an additional log file (``cli.log``) which contains more in-depth logging information, including the output.
+Additionally, the history of CLI commands is located in ``cli_history.log`` (or it can be accessed via the :ref:`command_history` command).
+
+The location of the CLI-specific log files can be set using FIREWHEEL's configuration.
 
 .. toctree::
-    :hidden:
 
-    usage.rst
-    cli_design.rst
-    cli_extention.rst
     commands.rst
     helper_docs.rst

docs/source/cli/index.rst

@@ -340,9 +340,9 @@ def make_index(self, basepath):
         # Get the list of model components
         index = """.. _available_model_components:
 
-#############################
-Model Component Documentation
-#############################
+##########################
+Available Model Components
+##########################
 
 """