Misc2 (#221)

* docs: Add FAQ entry for issues writing to markdown files and provide troubleshooting steps

* docs: Update fast edits documentation and add new settings image

* docs: Update Fast Edits documentation to clarify configuration and rename section

Author: hannesrudolph

docs/faq.md

@@ -162,6 +162,27 @@ The error message should provide some information about the problem. If you're u
 
 Roo Code uses VS Code's built-in file editing capabilities.  You can use the standard "Undo" command (Ctrl/Cmd + Z) to revert changes. Also, if experimental checkpoints are enabled, Roo can revert changes made to a file.
 
+### Roo Code can't write to markdown files. What's wrong?
+
+If Roo Code fails to write to `.md` files with errors like "Failed to open diff editor" or "write_to_file tool failed", this is typically caused by VS Code extensions or settings that interfere with file editing:
+
+**Common causes:**
+- Extensions with "format on save" functionality
+- VS Code settings that open markdown files in preview mode by default
+- The Markdown Preview extension or similar markdown processing extensions
+
+**Solutions:**
+- Disable any extensions that automatically format files on save
+- Remove these settings from your VS Code `settings.json`:
+  ```json
+  "markdown.preview.openMarkdownLinks": "inPreview",
+  "workbench.editorAssociations": {
+    "*.md": "vscode.markdown.preview.editor"
+  }
+  ```
+- Temporarily disable markdown-related extensions to test if they're causing the issue
+- Restart VS Code after making these changes
+
 ### How do I report a bug or suggest a feature?
 
 Please report bugs or suggest features on the Roo Code [Issues page](https://github.com/RooCodeInc/Roo-Code/issues) and [Feature Requests page](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop).

docs/features/api-configuration-profiles.mdx

@@ -32,7 +32,7 @@ Configuration profiles can have their own:
 - [Temperature settings](/features/model-temperature) for controlling response randomness
 - Thinking budgets
 - Provider-specific settings
-- Diff editing configuration
+- [Diff editing configuration](/features/fast-edits)
 - Rate limit settings
 
 Note that available settings vary by provider and model. Each provider offers different configuration options, and even within the same provider, different models may support different parameter ranges or features.
@@ -111,5 +111,5 @@ API keys are stored securely in VSCode's Secret Storage and are never exposed in
 - Integrates with [local models](/advanced-usage/local-models) for offline work
 - Supports [temperature settings](/features/model-temperature) per mode
 - Supports per-profile rate limits (configured here) and general [usage tracking/cost info](/advanced-usage/rate-limits-costs)
-- Supports per-profile diff editing configuration (v3.12+) for tailored code editing behavior
+- Supports [Diff/Fast Edits](/features/fast-edits) for tailored code editing behavior.
 

docs/features/fast-edits.md

@@ -1,20 +1,22 @@
-# Fast Edits
+# Diff/Fast Edits
 
 :::info Default Setting
 Fast Edits (using the "Enable editing through diffs" setting) is enabled by default in Roo Code. You typically don't need to change these settings unless you encounter specific issues or want to experiment with different diff strategies.
 :::
 
 Roo Code offers an advanced setting to change how it edits files, using diffs (differences) instead of rewriting entire files. Enabling this feature provides significant benefits.
 
-## Enable Editing Through Diffs
-
-Open Settings by clicking the gear icon <Codicon name="gear" /> → Advanced
+:::note Per-Provider Setting
+Diff editing configuration is set per [API Configuration Profile](/features/api-configuration-profiles), allowing you to customize editing behavior for different providers and models.
+:::
 
+## Enable Editing Through Diffs
 
+Open the Roo Code pane settings by clicking the gear icon <Codicon name="gear" />. The `Providers` section will be visible. Select the specific [API Configuration Profile](/features/api-configuration-profiles) you want to configure.
 
 When **Enable editing through diffs** is checked:
 
-    <img src="/img/fast-edits/fast-edits-5.png" alt="Roo Code settings showing Enable editing through diffs" width="500" />
+    <img src="/img/fast-edits/fast-edits-2.png" alt="Roo Code settings showing Enable editing through diffs" width="500" />
 1.  **Faster File Editing**: Roo modifies files more quickly by applying only the necessary changes.
 2.  **Prevents Truncated Writes**: The system automatically detects and rejects attempts by the AI to write incomplete file content, which can happen with large files or complex instructions. This helps prevent corrupted files.