fix: update documentation links and descriptions for modes and marketplace features

Author: hannesrudolph

docs/basic-usage/using-modes.md

@@ -118,4 +118,4 @@ Each tool group provides specific capabilities:
 - **`command`**: Terminal command execution
 - **`mcp`**: Model Context Protocol server interactions
 
-For detailed information about available tools, see the [Available Tools documentation](/advanced-usage/available-tools).
+For detailed information about available tools, see the [Available Tools documentation](/advanced-usage/available-tools/tool-use-overview).

docs/features/marketplace.mdx

@@ -64,14 +64,14 @@ When you install an item from the marketplace, you can choose to install it at t
 - **Scope**: The item is only available within the current VS Code workspace (your project).
 - **Configuration File**:
     - **MCPs**: [`.roo/mcp.json`](/features/mcp/using-mcp-in-roo#configuring-mcp-servers) in the root of your project.
-    - **Modes**: [`.roomodes`](/features/custom-modes#manual-configuration-yaml--json) in the root of your project.
+    - **Modes**: [`.roomodes`](/features/custom-modes#manual-configuration-yaml-json) in the root of your project.
 - **Use Case**: This is useful when an item is specific to a particular project's needs or when you want to share a project-specific configuration with your team.
 
 ### Global Installation
 - **Scope**: The item is available across all your VS Code workspaces.
 - **Configuration File**:
     - **MCPs**: [`mcp_settings.json`](/features/mcp/using-mcp-in-roo#configuring-mcp-servers) in the Roo Code extension's global settings directory.
-    - **Modes**: [`custom_modes.yaml`](/features/custom-modes#manual-configuration-yaml--json) in the Roo Code extension's global settings directory.
+    - **Modes**: [`custom_modes.yaml`](/features/custom-modes#manual-configuration-yaml-json) in the Roo Code extension's global settings directory.
 - **Use Case**: This is ideal for items that you want to use in all your projects, such as a favorite Mode or a commonly used MCP.
 
 ---

docs/update-notes/v3.20.0.mdx

@@ -1,6 +1,6 @@
 # Roo Code 3.20.0 Release Notes (2025-06-12)
 
-This release introduces the experimental Marketplace for extensions and modes, multi-file edits, and numerous other improvements and bug fixes.
+This release introduces the experimental Marketplace for extensions and modes, concurrent file edits and reads, and numerous other improvements and bug fixes.
 
 ## MCP & Mode Marketplace (experimental)
 
@@ -17,27 +17,27 @@ We've introduced an experimental [Marketplace](/features/marketplace) for discov
 
 ## Concurrent Edits (aka multi-file)(experimental)
 
-You can now perform edits across multiple files at once, dramatically speeding up refactoring and multi-file changes. Instead of approving each file edit individually, you can review and approve all changes at once through a unified batch approval interface.
+You can now perform edits across multiple files at once, dramatically speeding up refactoring and multi-file changes. Instead of approving each file edit individually, you can review and approve all changes at once through a unified batch approval interface. Check out our [concurrent file edits documentation](/features/experimental/concurrent-file-edits) for more details.
 
 **To enable:** Open Roo Code settings (gear icon) → Experimental Settings → Enable "Enable multi-file edits"
 
-For more information, see the [documentation](/features/experimental/concurrent-file-edits). (thanks samhvw8!) ([#4608](https://github.com/RooCodeInc/Roo-Code/pull/4608))
+(thanks samhvw8!) ([#4608](https://github.com/RooCodeInc/Roo-Code/pull/4608))
 
 <img src="/img/concurrent-file-edits/concurrent-file-edits-1.png" alt="Batch diff approval interface showing multiple file changes" width="600" />
 
 ## Concurrent Reads (aka multi-file)
 
-The setting for concurrent reads has been moved to the context settings, with a default of 5. This feature allows Roo to read multiple files from your workspace in a single step, significantly improving efficiency when working on tasks that require context from several files.
+The setting for concurrent reads has been moved to the context settings, with a default of 5. This feature allows Roo to read multiple files from your workspace in a single step, significantly improving efficiency when working on tasks that require context from several files. Learn more in our [concurrent file reads documentation](/features/concurrent-file-reads).
 
-For more information, see the [documentation](/features/concurrent-file-reads). ([#4597](https://github.com/RooCodeInc/Roo-Code/pull/4597))
+([#4597](https://github.com/RooCodeInc/Roo-Code/pull/4597))
 
 <img src="/img/concurrent-file-reads/concurrent-file-reads-2.png" alt="Batch approval interface for reading multiple files" width="600" />
 
 ## Prompt History
 
-Navigate your prompt history with a terminal-like experience using the arrow keys. This feature makes it easy to reuse and refine previous prompts, whether from your current conversation or past tasks.
+Navigate your prompt history with a terminal-like experience using the arrow keys. This feature makes it easy to reuse and refine previous prompts, whether from your current conversation or past tasks. See our [keyboard shortcuts documentation](/features/keyboard-shortcuts#command-line-style-prompt-history-navigation) for usage details.
 
-For more information, see the [documentation](/features/keyboard-shortcuts#command-line-style-prompt-history-navigation). ([#4580](https://github.com/RooCodeInc/Roo-Code/pull/4580))
+([#4580](https://github.com/RooCodeInc/Roo-Code/pull/4580))
 
 ## QOL Improvements
 

docs/update-notes/v3.20.mdx

@@ -1,6 +1,6 @@
 # Roo Code 3.20 Release Notes (2025-06-12)
 
-This release introduces the experimental Marketplace for extensions and modes, multi-file edits, and numerous other improvements and bug fixes.
+This release introduces the experimental Marketplace for extensions and modes, concurrent file edits and reads, and numerous other improvements and bug fixes.
 
 ## MCP & Mode Marketplace (experimental)
 
@@ -17,27 +17,27 @@ We've introduced an experimental [Marketplace](/features/marketplace) for discov
 
 ## Concurrent Edits (aka multi-file)(experimental)
 
-You can now perform edits across multiple files at once, dramatically speeding up refactoring and multi-file changes. Instead of approving each file edit individually, you can review and approve all changes at once through a unified batch approval interface.
+You can now perform edits across multiple files at once, dramatically speeding up refactoring and multi-file changes. Instead of approving each file edit individually, you can review and approve all changes at once through a unified batch approval interface. Check out our [concurrent file edits documentation](/features/experimental/concurrent-file-edits) for more details.
 
 **To enable:** Open Roo Code settings (gear icon) → Experimental Settings → Enable "Enable multi-file edits"
 
-For more information, see the [documentation](/features/experimental/concurrent-file-edits). (thanks samhvw8!) ([#4608](https://github.com/RooCodeInc/Roo-Code/pull/4608))
+(thanks samhvw8!) ([#4608](https://github.com/RooCodeInc/Roo-Code/pull/4608))
 
 <img src="/img/concurrent-file-edits/concurrent-file-edits-1.png" alt="Batch diff approval interface showing multiple file changes" width="600" />
 
 ## Concurrent Reads (aka multi-file)
 
-The setting for concurrent reads has been moved to the context settings, with a default of 5. This feature allows Roo to read multiple files from your workspace in a single step, significantly improving efficiency when working on tasks that require context from several files.
+The setting for concurrent reads has been moved to the context settings, with a default of 5. This feature allows Roo to read multiple files from your workspace in a single step, significantly improving efficiency when working on tasks that require context from several files. Learn more in our [concurrent file reads documentation](/features/concurrent-file-reads).
 
-For more information, see the [documentation](/features/concurrent-file-reads). ([#4597](https://github.com/RooCodeInc/Roo-Code/pull/4597))
+([#4597](https://github.com/RooCodeInc/Roo-Code/pull/4597))
 
 <img src="/img/concurrent-file-reads/concurrent-file-reads-2.png" alt="Batch approval interface for reading multiple files" width="600" />
 
 ## Prompt History
 
-Navigate your prompt history with a terminal-like experience using the arrow keys. This feature makes it easy to reuse and refine previous prompts, whether from your current conversation or past tasks.
+Navigate your prompt history with a terminal-like experience using the arrow keys. This feature makes it easy to reuse and refine previous prompts, whether from your current conversation or past tasks. See our [keyboard shortcuts documentation](/features/keyboard-shortcuts#command-line-style-prompt-history-navigation) for usage details.
 
-For more information, see the [documentation](/features/keyboard-shortcuts#command-line-style-prompt-history-navigation). ([#4580](https://github.com/RooCodeInc/Roo-Code/pull/4580))
+([#4580](https://github.com/RooCodeInc/Roo-Code/pull/4580))
 
 ## QOL Improvements