docs: Update release notes for versions 3.15.0 and 3.15.1, add new images, and enhance code actions documentation (#166)

Author: hannesrudolph

docs/features/code-actions.md

@@ -16,9 +16,8 @@ Clicking the lightbulb, right-clicking and selecting "Roo Code", or using the ke
 
 Roo Code provides the following Code Actions:
 
-*   **Add to Context:** Quickly adds the selected code to your chat with Roo, including line numbers so Roo knows exactly where the code is from. It's listed first in the menu for easy access. (More details below).
+*   **Add to Context:** Quickly adds the selected code to your chat with Roo, including the filename and line numbers so Roo knows exactly where the code is from. It's listed first in the menu for easy access.
 *   **Explain Code:** Asks Roo Code to explain the selected code.
-*   **Fix Code:** Asks Roo Code to fix problems in the selected code (available when diagnostics are present).
 *   **Improve Code:** Asks Roo Code to suggest improvements to the selected code.
 
 ### Add to Context Deep Dive
@@ -36,8 +35,6 @@ Can you explain this function?
 
 *(Where `@myFile.js:15:25` represents the code added via "Add to Context")*
 
-Each of these actions can be performed "in a new task" or "in the current task."
-
 ## Using Code Actions
 
 There are three main ways to use Roo Code's Code Actions:
@@ -62,22 +59,15 @@ There are three main ways to use Roo Code's Code Actions:
 
 1.  **Select Code:** Select the code you want to work with.
 2.  **Open the Command Palette:** Press `Ctrl+Shift+P` (Windows/Linux) or `Cmd+Shift+P` (macOS).
-3.  **Type a Command:** Type "Roo Code" to filter the commands, then choose the relevant code action (e.g., "Roo Code: Explain Code"). You can also type the start of the command, like "Roo Code: Explain", and select from the filtered list.
+3.  **Type a Command:** Type "Roo Code" to filter the commands, then choose the relevant code action (e.g., "Roo Code: Explain Code"). The action will apply in the most logical context (usually the current active chat task, if one exists).
 4.  **Review and Approve:** Roo Code will propose a solution in the chat panel. Review the proposed changes and approve or reject them.
 
-## Code Actions and Current Task
-
-Each code action gives you two options:
-
-*   **in New Task:** Select this to begin a conversation with Roo centered around this code action.
-*   **in Current Task:** If a conversation has already begun, this option will add the code action as an additional message.
-
 ## Customizing Code Action Prompts
 
 You can customize the prompts used for each Code Action by modifying the "Support Prompts" in the **Prompts** tab.  This allows you to fine-tune the instructions given to the AI model and tailor the responses to your specific needs.
 
 1.  **Open the Prompts Tab:** Click the <Codicon name="notebook" /> icon in the Roo Code top menu bar.
-2. **Find "Support Prompts":** You will see the support prompts, including "Enhance Prompt", "Explain Code", "Fix Code", and "Improve Code".
+2. **Find "Support Prompts":** You will see the support prompts, including "Enhance Prompt", "Explain Code", and "Improve Code".
 3. **Edit the Prompts:**  Modify the text in the text area for the prompt you want to customize. You can use placeholders like `${filePath}` and `${selectedText}` to include information about the current file and selection.
 4. **Click "Done":** Save your changes.
 

docs/features/shell-integration.md

@@ -12,7 +12,9 @@ Shell integration is automatically enabled in Roo Code and connects directly to
 - Observe command exit codes to determine success or failure
 - Track working directory changes as you navigate your project
 - React intelligently to terminal output without user intervention
+- Stop running commands directly from the chat interface using the stop button that appears next to the command execution message.
 
+  <img src="/img/v3.15/v3.15.png" alt="Stop Command Button in Chat UI" width="600" />
 When you ask Roo to perform tasks like installing dependencies, starting a development server, or analyzing build errors, shell integration works behind the scenes to make these interactions smooth and effective.
 
 ## Troubleshooting Shell Integration
@@ -25,6 +27,16 @@ Shell integration is built into Roo Code and works automatically in most cases.
 4. **WSL users**: Add `. "$(code --locate-shell-integration-path bash)"` to your `~/.bashrc`
 
 ## Terminal Integration Settings
+### Command Execution Fallback
+
+Roo Code includes a fallback mechanism to ensure commands can still run even if VSCode's native shell integration fails or is unavailable.
+
+- **How it works**: If Roo Code cannot connect to the terminal using standard shell integration, it will automatically attempt to execute the command directly using a background process.
+- **Notification**: You'll see a notification in the chat if this fallback is used, indicating that the command is running without full shell integration features (like real-time output streaming or exit code detection might be limited).
+- **Resolution**: The notification will include links to help you troubleshoot the underlying shell integration issue if you wish to restore full functionality. Often, following the steps in this document resolves the problem.
+
+  <img src="/img/v3.15.0/v3.15.0.png" alt="Stop Command Button in Chat UI" width="600" />
+
 
 Roo Code provides several settings to fine-tune shell integration. Access these in the Roo Code sidebar under Settings → Terminal.
 

docs/update-notes/index.md

@@ -1,4 +1,6 @@
 - [3.15](/update-notes/v3.15) (2025-04-30)
+*   [3.15.1](/update-notes/v3.15.1) (2025-04-30)
+*   [3.15.0](/update-notes/v3.15.0) (2025-04-30)
 # Update Notes
 
 This section contains notes about recent updates to Roo Code, listed by version number.

docs/update-notes/v3.15.0.md

@@ -0,0 +1,49 @@
+# Roo Code 3.15.0 Release Notes (2025-04-30)
+
+This release introduces prompt caching for Google Vertex, improved terminal command handling, UI/UX enhancements, and several other improvements and bug fixes.
+
+## Prompt Caching for Google Vertex
+
+*   Added prompt caching capabilities to the Google Vertex provider for potentially faster and more cost-effective responses (thanks ashktn).
+
+## Improved Terminal Command Handling
+
+*   Implemented a [fallback mechanism](/features/shell-integration#command-execution-fallback) for executing terminal commands if VSCode terminal shell integration fails.
+*   Added the ability to stop commands directly from the chat UI.
+
+    <img src="/img/v3.15.0/v3.15.0-2.png" width="600" />
+
+## Settings Import/Export
+
+*   Roo Code settings can now be imported directly from the welcome screen (thanks julionav).
+
+    <img src="/img/v3.15.0/v3.15.0-1.png" width="600" />
+
+*   Fixed importing & exporting of custom modes (thanks julionav).
+
+## QOL Improvements
+
+*   Improved the UI/UX of code snippets in the chat (thanks KJ7LNW).
+*   Adjusted chat view padding to accommodate small width layouts (thanks zhangtony239).
+*   Simplified and streamlined Roo Code's [quick actions](/features/code-actions).
+
+    <img src="/img/v3.15/v3.15-1.png" width="350" />
+
+*   Improved the auto-approve toggle buttons for some high-contrast VSCode themes.
+*   Offloaded expensive count token operations to a web worker for better performance (thanks samhvw8).
+*   Improved support for multi-root workspaces (thanks snoyiatk).
+*   Improved the performance of mode switching (thanks dlab-anton).
+
+## Bug Fixes
+
+*   Fixed file mentions for filenames containing spaces.
+*   Fixed importing & exporting of custom modes (thanks julionav).
+
+## Provider Updates
+
+*   **Google Vertex:** Added prompt caching (thanks ashktn).
+*   **OpenAI Compatible:** Added a reasoning effort setting (thanks mr-ryan-james).
+
+## Misc Improvements
+
+*   Removed unused types (thanks wkordalski).

docs/update-notes/v3.15.1.md

@@ -0,0 +1,13 @@
+# Roo Code 3.15.1 Release Notes (2025-04-30)
+
+This patch release includes several bug fixes and quality-of-life improvements.
+
+## Bug Fixes
+
+*   Made retries respect the global auto-approve checkbox.
+*   Fixed a selection mode bug in the history view (thanks jr!).
+*   Fixed the new intigrated terminal to capture stderr in execa-spawned processes.
+
+## QOL Improvements
+
+*   Play notification sound (when enabled) only when action is needed from the user (thanks olearycrew!).

docs/update-notes/v3.15.md

@@ -8,26 +8,34 @@ This release introduces prompt caching for Google Vertex, improved terminal comm
 
 ## Improved Terminal Command Handling
 
-*   Implemented a fallback mechanism for executing terminal commands if VSCode terminal shell integration fails.
+*   Implemented a [fallback mechanism](/features/shell-integration#command-execution-fallback) for executing terminal commands if VSCode terminal shell integration fails.
 *   Added the ability to stop commands directly from the chat UI.
 
+    <img src="/img/v3.15.0/v3.15.0-2.png" width="600" />
+
 ## Settings Import/Export
 
 *   Roo Code settings can now be imported directly from the welcome screen (thanks julionav).
 *   Fixed importing & exporting of custom modes (thanks julionav).
 
 ## QOL Improvements
 
+*   Play notification sound (when enabled) only when action is needed from the user (thanks olearycrew!).
 *   Improved the UI/UX of code snippets in the chat (thanks KJ7LNW).
 *   Adjusted chat view padding to accommodate small width layouts (thanks zhangtony239).
-*   Simplified and streamlined Roo Code's quick actions.
+*   Simplified and streamlined Roo Code's [quick actions](/features/code-actions).
+
+    <img src="/img/v3.15/v3.15-1.png" width="350" />
+
 *   Improved the auto-approve toggle buttons for some high-contrast VSCode themes.
 *   Offloaded expensive count token operations to a web worker for better performance (thanks samhvw8).
 *   Improved support for multi-root workspaces (thanks snoyiatk).
 *   Improved the performance of mode switching (thanks dlab-anton).
 
 ## Bug Fixes
 
+*   Made retries respect the global auto-approve checkbox.
+*   Fixed a selection mode bug in the history view (thanks jr!).
 *   Fixed file mentions for filenames containing spaces.
 *   Fixed importing & exporting of custom modes (thanks julionav).
 

sidebars.ts

@@ -171,15 +171,17 @@ const sidebars: SidebarsConfig = {
           label: '3.15',
           items: [
             { type: 'doc', id: 'update-notes/v3.15', label: '3.15 Combined' },
+            { type: 'doc', id: 'update-notes/v3.15.1', label: '3.15.1' },
+            { type: 'doc', id: 'update-notes/v3.15.0', label: '3.15.0' },
           ],
         },
         {
           type: 'category',
           label: '3.14',
           items: [
-{ type: 'doc', id: 'update-notes/v3.14', label: '3.14 Combined' },
-{ type: 'doc', id: 'update-notes/v3.14.3', label: '3.14.3' },
-{ type: 'doc', id: 'update-notes/v3.14.2', label: '3.14.2' },
+            { type: 'doc', id: 'update-notes/v3.14', label: '3.14 Combined' },
+            { type: 'doc', id: 'update-notes/v3.14.3', label: '3.14.3' },
+            { type: 'doc', id: 'update-notes/v3.14.2', label: '3.14.2' },
             { type: 'doc', id: 'update-notes/v3.14.1', label: '3.14.1' },
             { type: 'doc', id: 'update-notes/v3.14.0', label: '3.14.0' },
           ],