1 files changed, 41 insertions, 24 deletions
diff --git a/docs/tools/web-fetch.md b/docs/tools/web-fetch.md
index 061b353e..a9647df2 100644
--- a/docs/tools/web-fetch.md
+++ b/docs/tools/web-fetch.md
@@ -1,27 +1,44 @@
-# Web Fetch Tool
+# Web Fetch Tool (`web_fetch`)
 
-This document describes the `web_fetch` tool.
+This document describes the `web_fetch` tool for the Gemini CLI.
 
-## `web_fetch`
+## Description
 
-- **Purpose:** Processes content from one or more URLs (up to 20) embedded in a prompt. This tool is ideal for tasks that require summarizing, comparing, or extracting specific information from web pages.
-- **Arguments:**
-  - `prompt` (string, required): A comprehensive prompt that includes the URL(s) (up to 20) to fetch and specific instructions on how to process their content. For example: `"Summarize https://example.com/article and extract key points from https://another.com/data"`. The prompt must contain at least one URL starting with `http://` or `https://`.
-- **Behavior:**
-  - The tool will first ask for confirmation before fetching any URLs.
-  - It attempts to process URLs through the Gemini API's `urlContext` tool first.
-  - If the Gemini API cannot access a URL (e.g., it's on `localhost`, a private network, or behind a firewall), the tool will fall back to fetching the content directly from the local machine.
-  - The tool can fetch content from `localhost` and private network addresses via this fallback mechanism.
-  - The tool formats the response, including source attribution with citations where possible, and returns it to the user.
-- **Examples:**
-  - Summarizing a single article:
-    ```
-    web_fetch(prompt="Can you summarize the main points of https://example.com/news/latest")
-    ```
-  - Comparing two articles:
-    ```
-    web_fetch(prompt="What are the differences in the conclusions of these two papers: https://arxiv.org/abs/2401.0001 and https://arxiv.org/abs/2401.0002?")
-    ```
-- **Important Notes:**
-  - This tool relies on the Gemini API's ability to access and process the given URLs.
-  - The quality of the output depends on the clarity of the instructions in the prompt.
+Use `web_fetch` to summarize, compare, or extract information from web pages. The `web_fetch` tool processes content from one or more URLs (up to 20) embedded in a prompt. `web_fetch` takes a natural language prompt and returns a generated response.
+
+### Arguments
+
+`web_fetch` takes one argument:
+
+- `prompt` (string, required): A comprehensive prompt that includes the URL(s) (up to 20) to fetch and specific instructions on how to process their content. For example: `"Summarize https://example.com/article and extract key points from https://another.com/data"`. The prompt must contain at least one URL starting with `http://` or `https://`.
+
+## How to use `web_fetch` with the Gemini CLI
+
+To use `web_fetch` with the Gemini CLI, provide a natural language prompt that contains URLs. The tool will ask for confirmation before fetching any URLs. Once confirmed, the tool will process URLs through Gemini API's `urlContext`.
+
+If the Gemini API cannot access the URL, the tool will fall back to fetching content directly from the local machine. The tool will format the response, including source attribution and citations where possible. The tool will then provide the response to the user.
+
+Usage:
+
+```
+web_fetch(prompt="Your prompt, including a URL such as https://google.com.")
+```
+
+## `web_fetch` examples
+
+Summarize a single article:
+
+```
+web_fetch(prompt="Can you summarize the main points of https://example.com/news/latest")
+```
+
+Compare two articles:
+
+```
+web_fetch(prompt="What are the differences in the conclusions of these two papers: https://arxiv.org/abs/2401.0001 and https://arxiv.org/abs/2401.0002?")
+```
+
+## Important notes
+
+- **URL processing:** `web_fetch` relies on the Gemini API's ability to access and process the given URLs.
+- **Output quality:** The quality of the output will depend on the clarity of the instructions in the prompt.