fix: docs audit corrections — remove phantom features & fix 15 factual errors#543
Merged
hannesrudolph merged 2 commits intoRooCodeInc:mainfrom Feb 19, 2026
Merged
Conversation
- F-01: Delete footgun-prompting.md (zero source implementation)
- F-03/F-21: Remove .roo/system-prompt-{mode} and loadSystemPromptFile refs
- F-14/F-20: Remove deprecated 'browser' tool group from all mode tables
- F-09: Rewrite read-file.md params (mode/offset/limit/indentation, not start_line/end_line)
- F-07: Fix search-replace.md — replaces ONE unique occurrence, errors on multiple
- F-08: Fix edit-file.md — exactly 1 occurrence + document old_string='' file creation
- F-06: Delete non-existent MULTI_FILE_APPLY_DIFF experiment section from apply-diff.md
- F-10: Fix MCP server-transports config key mcp.servers → mcpServers
- F-11: Clarify SSE type is required for URL-based configs, not universally optional
- F-02: DeepSeek R1 default temperature 0.6 → 0.3
- F-12: Remove experiment flag references from concurrent-file-edits.md
- F-13: Add .agents/skills/ discovery paths to skills.mdx and skill.md
- F-15: Add Roo provider alongside OpenRouter in generate-image.md
- Remove invalid footgun-prompting redirect from docusaurus.config.ts
- Remove broken footgun-prompting links from v3.14 release notes
SannidhyaSah
requested review from
cte,
hannesrudolph and
mrubens
as code owners
|
Someone is attempting to deploy a commit to the Roo Code Team on Vercel. A member of the Team first needs to authorize it. |
Contributor
All previously flagged issues have been resolved. No new issues found.
Mention @roomote in a comment to request specific changes to this pull request or fix all unresolved issues. |
![roomote[bot]](https://avatars.githubusercontent.com/in/1546624?s=60&v=4){kind=small}
…emantics Address review comment: 'When is it used?' still described global replacement use cases (throughout a file, all instances) contradicting the updated single-match behavior. Rewrote to describe targeted, unique-location changes.
Contributor
Author
|
Fixed in e96ccc7 — rewrote the "When is it used?" section in |
hannesrudolph
approved these changes
Feb 19, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR applies all fixes identified in the documentation audit report. Every change was verified against the actual source code in
RooCodeInc/Roo-Codebefore being applied. The build passes cleanly with zero warnings (pnpm run build).Section 1 — Complete Deletions
F-01 · Delete
footgun-prompting.mddocs/advanced-usage/footgun-prompting.md— documents a.roo/system-prompt-{mode}file-based override that has zero implementation in source codesidebars.tsdocusaurus.config.tsdocs/update-notes/v3.14.mdandv3.14.0.md(historical content preserved, only the dead hyperlinks removed)F-03 & F-21 ·
prompt-structure.md— remove non-existent feature references.roo/system-prompt-<mode_slug>override, which doesn't exist in source)loadSystemPromptFilefrom the Technical Implementation section (function doesn't exist).roo/rules/and.roo/rules-{mode}/files which DO existF-14 & F-20 · Remove deprecated
browsertool groupdocs/features/custom-modes.mdx: Removed"browser"from valid tool groups list; removed from 3 YAML/JSON examplesdocs/basic-usage/using-modes.md: Removedbrowserfrom all 4 built-in mode tables (Code, Ask, Architect, Debug) and from Understanding Tool Groups sectionpackages/types/src/tool.tsline 16 —browseris indeprecatedToolGroupsand is silently strippedSection 2 — Critical Parameter / Schema Fixes
F-09 ·
read-file.md— rewrite parameter schemamode,offset,limit,indentationstart_lineandend_linedo not existF-07 ·
search-replace.md— ONE occurrence, not allF-08 ·
edit-file.md— exactly 1 +old_string=""file creation modeold_string=""mode: creates new file or appends to existing fileF-06 ·
apply-diff.md— delete non-existent experiment sectionMULTI_FILE_APPLY_DIFF)" sectionMULTI_FILE_APPLY_DIFFexperiment flag doesn't exist inpackages/types/src/experiment.tsMultiFileSearchReplaceDiffStrategyclass doesn't exist in sourceF-10 ·
server-transports.md— fix config key"mcp.servers"→"mcpServers"src/services/mcp/McpHub.ts:146F-11 ·
using-mcp-in-roo.mdx— SSEtypefield is required for URL configscommandproperty):typedefaults to"stdio"and can be omittedtypecauses an immediate throw — it is not optionalSection 3 — Factual Corrections
F-02 ·
model-temperature.md— DeepSeek default temperature0.6→0.3packages/types/src/providers/deepseek.ts:38—DEEP_SEEK_DEFAULT_TEMPERATURE = 0.3F-12 ·
concurrent-file-edits.md— remove experiment flag referencesMultiFileSearchReplaceDiffStrategy(doesn't exist)F-13 ·
skills.mdx+skill.md— add missing.agents/discovery pathsVerified against
src/services/skills/SkillsManager.ts. Added the following missing paths:~/.agents/skills/(user-home global, cross-agent).agents/skills/(project-level, cross-agent)~/.agents/skills-{mode}/(global mode-specific, cross-agent).agents/skills-{mode}/(project mode-specific, cross-agent).roo/beats.agents/at same level):::warning Custom System Prompts Override Skillsblock (references non-existent feature)skill.mdHow It Works section to list all 8 resolution pathsF-15 ·
generate-image.md— add Roo provider supportsrc/api/providers/utils/image-generation.ts: "Shared image generation implementation for OpenRouter and Roo Code Cloud providers"Files Changed (19 total)
docs/advanced-usage/footgun-prompting.mdsidebars.tsdocusaurus.config.tsdocs/update-notes/v3.14.mddocs/update-notes/v3.14.0.mddocs/advanced-usage/prompt-structure.mddocs/features/custom-modes.mdxdocs/basic-usage/using-modes.mddocs/advanced-usage/available-tools/read-file.mddocs/advanced-usage/available-tools/search-replace.mddocs/advanced-usage/available-tools/edit-file.mddocs/advanced-usage/available-tools/apply-diff.mddocs/features/mcp/server-transports.mddocs/features/mcp/using-mcp-in-roo.mdxdocs/features/model-temperature.mddocs/features/experimental/concurrent-file-edits.mddocs/features/skills.mdxdocs/advanced-usage/available-tools/skill.mddocs/advanced-usage/available-tools/generate-image.mdBuild Status
✅
pnpm run build— SUCCESS, zero warnings (verified by husky pre-commit hook)Start a new Roo Code Cloud session on this branch