moar docs (RooCodeInc#3689)

* title

* crosslinking and commands

* better

* fixing

* fixing inaccuracies

* language

* images

---------

Co-authored-by: Cline Evaluation <[email protected]>

Author: pashpashpash

docs/docs.json

@@ -74,9 +74,24 @@
 			{
 				"group": "Features",
 				"pages": [
-					"features/plan-and-act",
+					"features/auto-approve",
+					"features/checkpoints",
 					"features/cline-rules",
+					"features/drag-and-drop",
+					"features/plan-and-act",
 					"features/slash-commands/workflows",
+					"features/editing-messages",
+					{
+						"group": "@ Mentions",
+						"pages": [
+							"features/at-mentions/overview",
+							"features/at-mentions/file-mentions",
+							"features/at-mentions/terminal-mentions",
+							"features/at-mentions/problem-mentions",
+							"features/at-mentions/git-mentions",
+							"features/at-mentions/url-mentions"
+						]
+					},
 					{
 						"group": "Slash Commands",
 						"pages": [
@@ -87,14 +102,13 @@
 						]
 					},
 					{
-						"group": "@ Mentions",
+						"group": "Commands & Shortcuts",
 						"pages": [
-							"features/at-mentions/overview",
-							"features/at-mentions/file-mentions",
-							"features/at-mentions/terminal-mentions",
-							"features/at-mentions/problem-mentions",
-							"features/at-mentions/git-mentions",
-							"features/at-mentions/url-mentions"
+							"features/commands-and-shortcuts/overview",
+							"features/commands-and-shortcuts/code-commands",
+							"features/commands-and-shortcuts/terminal-integration",
+							"features/commands-and-shortcuts/git-integration",
+							"features/commands-and-shortcuts/keyboard-shortcuts"
 						]
 					}
 				]
@@ -103,10 +117,8 @@
 				"group": "Exploring Cline's Tools",
 				"pages": [
 					"exploring-clines-tools/cline-tools-guide",
-					"exploring-clines-tools/checkpoints",
 					"exploring-clines-tools/new-task-tool",
-					"exploring-clines-tools/remote-browser-support",
-					"exploring-clines-tools/slash-commands"
+					"exploring-clines-tools/remote-browser-support"
 				]
 			},
 			{

docs/exploring-clines-tools/checkpoints.mdx

@@ -29,6 +29,11 @@ As a quick alternative to Cline suggesting the `newtask` tool or defining comple
 -   **Action:** Cline will propose creating a new task, typically suggesting context based on the current session (similar to its default behavior when using the tool). You will still get the `ask_followup_question` prompt to confirm and potentially modify the context before the new task is created.
 -   **Benefit:** Provides a fast, user-initiated way to leverage the `new_task` functionality for branching explorations or managing long sessions without waiting for Cline to suggest it.
 
+<Note>
+	For more details on using the `/newtask` slash command, see the [New Task Command](/features/slash-commands/new-task)
+	documentation.
+</Note>
+
 #### Default Behavior (Without `.clinerules`)
 
 By default, without specific `.clinerules` dictating its behavior:

docs/exploring-clines-tools/new-task-tool.mdx

@@ -1,5 +1,5 @@
 ---
-title: "@ MentionsOverview"
+title: "@ Mentions Overview"
 sidebarTitle: "Overview"
 ---
 
@@ -15,35 +15,45 @@ When you type `@` in the chat input, Cline shows a menu of available mention typ
 
 Cline supports several types of @ mentions, each designed to bring different kinds of context into your conversations:
 
-<Card title="File Mentions" icon="file" href="/features/at-mentions/file-mentions">
-	Reference any file in your workspace with `@/path/to/file`. Cline sees the complete file content, including imports, related
-	functions, and surrounding context.
-</Card>
+<Columns cols={2}>
+  <Card title="File Mentions" icon="file" href="/features/at-mentions/file-mentions">
+    Reference any file in your workspace with `@/path/to/file`. Cline sees the complete file content, including imports, related
+    functions, and surrounding context.
+  </Card>
+
+{" "}
 
 <Card title="Folder Mentions" icon="folder" href="/features/at-mentions/folder-mentions">
 	Reference entire directories with `@/path/to/folder/`. Cline sees the folder structure and all file contents, perfect for
 	understanding complex interactions between multiple files.
 </Card>
 
+{" "}
+
 <Card title="Problem Mentions" icon="triangle-exclamation" href="/features/at-mentions/problem-mentions">
 	Use `@problems` to show Cline all the errors and warnings in your workspace. Cline sees the complete list with file locations
 	and error messages.
 </Card>
 
+{" "}
+
 <Card title="Terminal Mentions" icon="terminal" href="/features/at-mentions/terminal-mentions">
 	Use `@terminal` to share your recent terminal output. Cline sees the complete output with formatting preserved, perfect for
 	debugging build errors or test failures.
 </Card>
 
+{" "}
+
 <Card title="Git Mentions" icon="code-branch" href="/features/at-mentions/git-mentions">
 	Reference uncommitted changes with `@git-changes` or specific commits with `@[commit-hash]`. Cline sees the complete diff,
 	commit message, and other relevant information.
 </Card>
 
-<Card title="URL Mentions" icon="globe" href="/features/at-mentions/url-mentions">
-	Reference web content with `@https://example.com`. Cline fetches and sees the complete webpage content, perfect for
-	referencing documentation or GitHub issues.
-</Card>
+  <Card title="URL Mentions" icon="globe" href="/features/at-mentions/url-mentions">
+    Reference web content with `@https://example.com`. Cline fetches and sees the complete webpage content, perfect for
+    referencing documentation or GitHub issues.
+  </Card>
+</Columns>
 
 ## Why @ Mentions Matter
 

docs/exploring-clines-tools/slash-commands.mdx

@@ -0,0 +1,59 @@
+The Auto Approve menu lets you set fine-grained permissions on what you allow Cline to do in an automated way.
+
+<Frame>
+	<img src="https://storage.googleapis.com/cline_public_images/docs/assets/auto-approve.png" alt="Auto Approve" />
+</Frame>
+
+## How it works
+
+By default, Cline will ask for your permission before calling any tool, including reading or writing files.
+
+If you want to allow Cline to do something without asking, you can set the Auto Approve permission for that tool.
+
+## Permission Options
+
+-   **Read project files**
+
+    -   Allows Cline to read files within your current workspace without asking
+    -   **Read all files**
+        -   Extends read permission to files outside your workspace (system files, config files, etc.)
+
+-   **Edit project files**
+
+    -   Allows Cline to modify files within your current workspace without confirmation
+    -   **Edit all files**
+        -   Extends modification permission to files outside your workspace
+
+-   **Execute safe commands**
+
+    -   Allows execution of terminal commands that the model deems non-destructive
+    -   **Execute all commands**
+        -   Permits execution of any terminal command without asking
+
+-   **Use the browser**
+
+    -   Allows Cline to use the browser tool to fetch web content
+
+-   **Use MCP servers**
+
+    -   Permits connection to and usage of MCP servers for extended functionality
+
+-   **Maximum requests**
+    -   Sets the number of consecutive automated actions Cline can take before requiring your input
+
+## Best Practices
+
+Personally, I like to keep auto-editing disabled because it gives me a chance to review changes every step of the way.
+
+For most serious development workflows, I recommend starting with:
+
+-   Auto-approving read access to project files
+-   Setting a reasonable maximum request limit (10-20)
+
+This gives Cline enough freedom to explore your codebase without constant interruptions, while still requiring permission for edits or potentially destructive actions.
+
+As you build more trust in Cline's capabilities with your specific projects, you can gradually increase the permissions to match your comfort level.
+
+Remember that you can always adjust these settings as your needs change - tighten permissions for critical production work, or loosen them when prototyping and exploring.
+
+You can even use the quick "star" actions to quickly toggle your auto-approved selections on and off as you go.