Edit pass of docs/cli/index.md (#999)

Make a pass through the docs/deployment.md file to hopefully improve readability and conciseness

Notably, I've proposed axing both the "Core Features" section - which feels too promotional this far down the folder hierarchy and which is somewhat repetitive to later in the page - and the "Basic Interaction" section - which is covered better, and makes more sense, in other parts of the documentation

1 files changed, 9 insertions, 34 deletions

diff --git a/docs/cli/index.md b/docs/cli/index.md
index 24419d77..e0b41096 100644
--- a/docs/cli/index.md
+++ b/docs/cli/index.md
@@ -1,51 +1,26 @@
 # Gemini CLI
 
-The Gemini CLI (`packages/cli`) is the primary way users interact with the Gemini AI model and its associated tools directly from their terminal. For a general overview of the Gemini CLI, see the [main documentation page](../index.md).
+Within Gemini CLI, `packages/cli` is the frontend for users to send and receive prompts with the Gemini AI model and its associated tools. For a general overview of Gemini CLI, see the [main documentation page](../index.md).
 
-## Core Features
+## Navigating this section
 
-- **Interactive Prompt:** A familiar command-line prompt for entering your queries and commands.
-- **Rich Output Display:**
-  - Formatted Markdown rendering for clear and readable text responses.
-  - Syntax highlighting for code blocks in various languages.
-  - Clear display of tool calls, inputs, and outputs.
-- **Command History:** Easily access and re-run previous commands and prompts.
-- **Theming:** Customize the look and feel of the CLI to your preference. See [Themes section](./themes.md).
-- **Configuration:** Tailor the CLI's behavior through configuration files. See [CLI Configuration](./configuration.md).
-- **Special Commands:** Utilize built-in commands for tasks like managing history, memory, or display. See [Commands](./commands.md).
-- **Enhanced Input:** Support for multiline input editing and readline-like keybindings for a more comfortable and efficient command entry experience.
-
-## Basic Interaction
-
-1.  **Start the CLI:** Run `npm start` from the project root (or execute the installed CLI command directly). Refer to the main [README.md](../../README.md) for setup and running instructions.
-2.  **Enter a Prompt:** Type your question or instruction at the `>` prompt and press Enter.
-    ```
-    > Explain how to build a web app.
-    ```
-3.  **View Response:** Gemini's response will be displayed in the terminal. If Gemini needs to use a tool (e.g., to read a file you mentioned), you will see messages indicating the tool usage.
-4.  **Continue Conversation:** You can continue the conversation by asking follow-up questions or giving new instructions.
-
-## Navigating this Section
-
-- **[Commands](./commands.md):** A detailed reference for all built-in CLI commands (e.g., `/help`, `/history`, `/theme`).
-- **[Configuration](./configuration.md):** Understand how to configure various aspects of the CLI.
+- **[Commands](./commands.md):** A reference for Gemini CLI commands (e.g., `/help`, `/tools`, `/theme`).
+- **[Configuration](./configuration.md):** A guide to tailoring Gemini CLI behavior using configuration files.
 - **[Themes](./themes.md)**: A guide to customizing the CLI's appearance with different themes.
-- **[Tutorials](tutorials.md)**: A guide for mastering use of the CLI to automate your development tasks.
+- **[Tutorials](tutorials.md)**: A tutorial showing how to use Gemini CLI to automate a development task.
 
-## Non-Interactive Mode
+## Non-interactive mode
 
-The Gemini CLI can be run in a non-interactive mode, which is useful for scripting and automation. In this mode, you can pipe input to the CLI and it will execute the command and exit.
+Gemini CLI can be run in a non-interactive mode, which is useful for scripting and automation. In this mode, you pipe input to the CLI, it executes the command, and then it exits.
 
-To use the non-interactive mode, you can pipe a command to the CLI. For example:
+The following example pipes a command to Gemini CLI from your terminal:
 
 ```bash
 echo "What is fine tuning?" | gemini
 ```
 
-You can achieve the same result with the `--prompt` or `p` argument. For example:
+Gemini CLI executes the command and prints the output to your terminal. Note that you can achieve the same behavior by using the `--prompt` or `-p` flag. For example:
 
 ```bash
 gemini -p "What is fine tuning?"
 ```
-
-In both cases this will execute the command and print the output to the console.