Misc (#134)

* docs: clarify folder mention behavior and add important interactions

* docs: add mention of currently open files in context mentions dropdown

* docs: add note about handling empty override files in footgun prompting

* docs: add model selection advice for Claude 3.7 Sonnet in API provider guide

* docs: refine model selection advice for Claude 3.7 Sonnet in API provider guide

* docs: add comprehensive installation guide for Roo Code extension

Author: hannesrudolph

docs/basic-usage/context-mentions.md

@@ -44,7 +44,7 @@ Context mentions are a powerful way to provide Roo Code with specific informatio
 |------------|---------|
 | **Format** | `@/path/to/folder` (no trailing slash) |
 | **Provides** | Complete contents of all files within the directory |
-| **Includes** | Contents of all files directly within the folder (not recursive) |
+| **Includes** | Contents of non-binary text files directly within the folder (not recursive) |
 | **Best for** | Providing context from multiple files in a directory |
 | **Tip** | Be mindful of context window limits when mentioning large directories |
 
@@ -109,14 +109,18 @@ The dropdown automatically suggests:
 - Visible folders
 - Recent git commits
 - Special keywords (`problems`, `terminal`, `git-changes`)
+- **All currently open files** (regardless of ignore settings or directory filters)
 
-## Best Practices
+The dropdown automatically filters out common directories like `node_modules`, `.git`, `dist`, and `out` to reduce noise, even though their content could be included if manually typed.
 
-| Practice | Description |
+## Important Behaviors
+
+### Ignore File Interactions
+
+| Behavior | Description |
 |----------|-------------|
-| **Use specific paths** | Reference exact files rather than describing them |
-| **Use relative paths** | Always start from workspace root: `@/src/file.ts` not `@C:/Projects/src/file.ts` |
-| **Verify references** | Ensure paths and commit hashes are correct |
-| **Click mentions** | Click mentions in chat history to open files or view content |
-| **Eliminate copy-pasting** | Use mentions instead of manually copying code or errors |
-| **Combine mentions** | "Fix @problems in @/src/component.ts using the pattern from commit @a1b2c3d" |
+| **`.rooignore` bypass** | File and folder `@mentions` bypass `.rooignore` checks when fetching content for context. Content from ignored files will be included if directly mentioned. |
+| **`.gitignore` bypass** | Similarly, file and folder `@mentions` do not respect `.gitignore` rules when fetching content. |
+| **Git command respect** | Git-related mentions (`@git-changes`, `@commit-hash`) do respect `.gitignore` since they rely on Git commands. |
+
+

docs/features/footgun-prompting.md

@@ -46,6 +46,7 @@ You can find the option and instructions within the Roo Code UI:
 -   **Impact on Functionality:** Custom prompts override standard instructions, including those for tool usage and response consistency. This can cause unexpected behavior or errors if not managed carefully.
 -   **Mode-Specific:** Each override file applies only to the mode specified in its filename (`{mode-slug}`).
 -   **No File, No Override:** If the `.roo/system-prompt-{mode-slug}` file doesn't exist, Roo Code uses the standard system prompt generation process for that mode.
+-   **Blank Files Ignored:** If the override file exists but is empty (blank), it will be ignored and the default system prompt will be used.
 -   **Directory Creation:** Roo Code ensures the `.roo` directory exists before attempting to read or create the override file.
 
 Use this feature cautiously. While powerful for customization, incorrect implementation can significantly degrade Roo Code's performance and reliability for the affected mode.

docs/getting-started/connecting-api-provider.md

@@ -73,4 +73,11 @@ Once you have your API key:
 4. Select your model:
    - For **OpenRouter**: select `anthropic/claude-3.7-sonnet` ([model details](https://openrouter.ai/anthropic/claude-3.7-sonnet))
    - For **Anthropic**: select `claude-3-7-sonnet-20250219` ([model details](https://www.anthropic.com/pricing#anthropic-api))
+
+:::info Model Selection Advice
+We strongly recommend **Claude 3.7 Sonnet** for the best experience—it generally "just works" out of the box. Roo Code has been extensively optimized for this model's capabilities and instruction-following behavior.
+
+Selecting alternative models is an advanced feature that introduces complexity. Different models vary significantly in how they follow tool instructions, parse formats, and maintain context through multi-step operations. If you do experiment with other models, choose ones specifically designed for structured reasoning and tool use.
+:::
+
 5. Click "Let's go!" to save your settings and start using Roo Code

docs/getting-started/installing.md docs/getting-started/installing.mdxdocs/getting-started/installing.md renamed to docs/getting-started/installing.mdx

@@ -4,6 +4,22 @@ sidebar_label: Installing Roo Code
 
 # Installing Roo Code
 
+<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
+  <iframe
+    src="https://www.youtube.com/embed/Mcq3r1EPZ-4"
+    style={{
+      position: 'absolute',
+      top: 0,
+      left: 0,
+      width: '100%',
+      height: '100%',
+    }}
+    frameBorder="0"
+    allow="autoplay; encrypted-media"
+    allowFullScreen
+  ></iframe>
+</div>
+
 Roo Code is a VS Code extension that brings AI-powered coding assistance directly to your editor. Install using one of these methods:
 1. **VS Code Marketplace (Recommended)** - fastest method for standard VS Code and Cursor users
 2. **Open VSX Registry** - for VS Code-compatible editors like VSCodium