tweak docs

Author: dsyme

docs/src/content/docs/reference/engines.md

@@ -27,10 +27,6 @@ engine:
 - **`model`** (optional): AI model to use (`gpt-5` or defaults to `claude-sonnet-4`)
 - **`version`** (optional): Version of the GitHub Copilot CLI to install (defaults to `latest`)
 
-:::note
-The Copilot engine does not have built-in `web-search` support. You can add web search capabilities using third-party MCP servers. See the [Web Search with MCP guide](/gh-aw/guides/web-search/) for available options and setup instructions.
-:::
-
 **Environment Variables:**
 - **`COPILOT_MODEL`**: Alternative way to set the model (e.g., `gpt-5`)
 
@@ -54,6 +50,10 @@ gh secret set GITHUB_MCP_TOKEN -a actions --body "<your-github-pat>"
 
 See [GitHub Tools - Remote Mode](/gh-aw/reference/tools/#github-remote-mode) for more details.
 
+:::note
+The Copilot engine does not have built-in `web-search` support. You can add web search capabilities using third-party MCP servers. See the [Using Web Search](/gh-aw/guides/web-search/) for available options and setup instructions.
+:::
+
 ### Anthropic Claude Code
 
 Claude Code excels at reasoning, code analysis, and understanding complex contexts. It provides robust capabilities for agentic workflows.

docs/src/content/docs/reference/tools.md

@@ -7,6 +7,8 @@ sidebar:
 
 This guide covers the available tools that can be configured in agentic workflows, including GitHub tools, Playwright browser automation, custom MCP servers, and neutral tools.
 
+## Overview
+
 Tools are defined in the frontmatter to specify which GitHub API calls, browser automation, and AI capabilities are available to your workflow:
 
 ```yaml
@@ -103,7 +105,7 @@ tools:
 ```
 
 :::note
-Some engines (like Copilot) don't have built-in `web-search` support. You can add web search using third-party MCP servers instead. See the [Web Search with MCP guide](/gh-aw/guides/web-search/) for options.
+Some engines (like Copilot) don't have built-in `web-search` support. You can add web search using third-party MCP servers instead. See the [Using Web Search](/gh-aw/guides/web-search/) for options.
 :::
 
 ## GitHub Tools (`github:`)