Apply docs-reviewer feedback to CLI page

- Add description to frontmatter
- Add "This page shows you" opening summary
- Replace redundant MIT callout with Node.js prerequisite note
- Make capabilities table verbs parallel (all imperative)
- Remove bold-before-colon pattern in developer features
- Add context line before git hooks example
- Add cross-reference to "Your first API request"

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: 2 people

docs/getting-started/deepl-cli.mdx

@@ -1,16 +1,25 @@
 ---
 title: "DeepL CLI"
+description: "Install and use the DeepL CLI to translate text, documents, and more from your terminal."
 public: true
 ---
 
-The [DeepL CLI](https://github.com/DeepLcom/deepl-cli) is an open-source (MIT license) command-line tool for interacting with the DeepL API. It covers text translation, document translation, writing enhancement, voice translation, glossary management, and admin operations — all from your terminal.
+**This page shows you:**
+- How to install the DeepL CLI from source
+- How to authenticate and run your first translation
+- What commands are available for translation, writing, voice, and more
 
-<Info>
-The DeepL CLI is open-source under the [MIT License](https://github.com/DeepLcom/deepl-cli/blob/main/LICENSE). Contributions and feedback are welcome!
-</Info>
+The [DeepL CLI](https://github.com/DeepLcom/deepl-cli) is an open-source (MIT license) command-line tool for interacting with the DeepL API. It covers text translation, document translation, writing enhancement, voice translation, glossary management, and admin operations — all from your terminal.
 
 ## Installation
 
+<Note>
+The CLI requires [Node.js](https://nodejs.org/) (v18+) and build tools for native compilation:
+- **macOS**: Xcode Command Line Tools (`xcode-select --install`)
+- **Linux**: `python3`, `make`, `gcc` (`apt install python3 make gcc g++`)
+- **Windows**: Visual Studio Build Tools
+</Note>
+
 ```bash
 git clone https://github.com/DeepLcom/deepl-cli.git
 cd deepl-cli
@@ -21,13 +30,6 @@ npm link
 deepl --version
 ```
 
-<Note>
-The CLI uses `better-sqlite3` for local caching, which requires native compilation. Ensure you have build tools installed:
-- **macOS**: Xcode Command Line Tools (`xcode-select --install`)
-- **Linux**: `python3`, `make`, `gcc` (`apt install python3 make gcc g++`)
-- **Windows**: Visual Studio Build Tools
-</Note>
-
 ## Quick start
 
 ### 1. Set up authentication
@@ -69,10 +71,10 @@ deepl write "Their going to the stor tommorow" --lang en-us
 | Command | Description |
 |---------|-------------|
 | `deepl translate` | Translate text with support for formality, context, and custom instructions |
-| `deepl translate --file` | Translate text files (preserves code blocks and formatting) |
+| `deepl translate --file` | Translate text files while preserving code blocks and formatting |
 | `deepl document` | Translate documents (PDF, DOCX, PPTX, XLSX) with format preservation |
-| `deepl write` | Grammar and style enhancement via DeepL Write |
-| `deepl voice` | Real-time speech translation via WebSocket streaming |
+| `deepl write` | Enhance grammar and style via DeepL Write |
+| `deepl voice` | Stream real-time speech translation via WebSocket |
 | `deepl watch` | Monitor files and auto-translate on change |
 | `deepl glossary` | Create, list, and manage glossaries |
 | `deepl admin` | Manage API keys, usage limits, and team access |
@@ -108,19 +110,22 @@ deepl watch ./content/en --to de,fr --output ./content/
 
 ### Git hooks integration
 
+Automatically translate changed files before each commit:
+
 ```bash
 deepl hooks install --pre-commit --languages de,fr
 ```
 
 ## Developer workflow features
 
-- **Smart caching**: Local SQLite cache with LRU eviction avoids redundant API calls
-- **Cost tracking**: Monitor billed characters for budget planning (`deepl usage`)
-- **CI/CD ready**: `--quiet` and `--no-input` flags for non-interactive pipelines
-- **Shell completion**: Generate completions for bash, zsh, fish, and PowerShell
+- Local SQLite cache with LRU eviction avoids redundant API calls
+- Monitor billed characters for budget planning with `deepl usage`
+- Use `--quiet` and `--no-input` flags for CI/CD pipelines
+- Generate shell completions for bash, zsh, fish, and PowerShell
 
 ## Further reading
 
 - [DeepL CLI on GitHub](https://github.com/DeepLcom/deepl-cli) — full documentation, changelog, and source code
 - [DeepL API authentication](/docs/getting-started/auth) — set up your API key
+- [Your first API request](/docs/getting-started/your-first-api-request) — understand how the API works
 - [Client libraries](/docs/getting-started/client-libraries) — official SDKs for six languages