Homepage tweaks (#53)

* Add a doc-writing mode

* Tweaks to homepage

Author: mrubens

.roomodes

@@ -0,0 +1,20 @@
+{
+  "customModes": [
+    {
+      "slug": "docs",
+      "name": "Documentation Writer",
+      "roleDefinition": "You are Roo, a skilled technical writer specializing in Docusaurus documentation. Your expertise includes:\n\n- Writing clear, concise, and engaging technical documentation\n- Following Docusaurus best practices and markdown conventions\n- Maintaining consistent documentation structure and style\n\nYou excel at:\n- Breaking down complex technical concepts into digestible chunks\n- Creating logical documentation hierarchies\n- Writing with a clear and friendly tone\n- Including practical examples and use cases\n- Maintaining documentation accuracy and freshness",
+      "customInstructions": "When writing documentation:\n1. Speak informally and directly - get to the point quickly\n2. Use relative paths for internal links without .md extensions\n3. Include practical examples\n4. Break up long sections with clear headings\n5. Use consistent formatting and style\n6. Ensure all code examples are properly formatted",
+      "groups": [
+        "read",
+        [
+          "edit",
+          {
+            "fileRegex": "\\.md[x]?$",
+            "description": "Markdown and MDX files only"
+          }
+        ]
+      ]
+    }
+  ]
+}

docs/index.md

@@ -4,7 +4,7 @@ sidebar_label: Welcome
 
 # Roo Code Docs
 
-Roo Code (formerly Roo Cline) is an AI-powered autonomous coding agent that lives in your editor, designed to help you code faster and smarter. Whether you're starting a new project, maintaining existing code, or learning new technologies, Roo Code is your intelligent coding companion.
+Roo Code (formerly Roo Cline) is an AI-powered autonomous coding agent that lives in your editor. It helps you code faster and smarter, whether you're starting a new project, maintaining existing code, or learning new technologies.
 
 ## What Can Roo Code Do?
 
@@ -28,13 +28,16 @@ Roo Code adapts to your needs with specialized [modes](basic-usage/modes):
 - **Code Mode:** For general-purpose coding tasks
 - **Architect Mode:** For planning and technical leadership
 - **Ask Mode:** For answering questions and providing information
+- **[Custom Modes](advanced-usage/custom-modes):** Create unlimited specialized personas for security auditing, performance optimization, documentation, or any other task
 
 ### Smart Tools
 Roo Code comes with powerful [tools](basic-usage/using-tools) that can:
 - Read and write files in your project
 - Execute commands in your VS Code terminal
-- Perform web browsing (if enabled)
-- Use external tools via MCP (Model Context Protocol)
+- Control a web browser
+- Use external tools via [MCP (Model Context Protocol)](advanced-usage/mcp)
+
+MCP extends Roo Code's capabilities by allowing you to add unlimited custom tools. Integrate with external APIs, connect to databases, or create specialized development tools - MCP provides the framework to expand Roo Code's functionality to meet your specific needs.
 
 ### Customization
 Make Roo Code work your way with: