General Doc Updates (#453)

Co-authored-by: ellipsis-dev[bot] <65095814+ellipsis-dev[bot]@users.noreply.github.com>
Co-authored-by: roomote[bot] <219738659+roomote[bot]@users.noreply.github.com>
Co-authored-by: Matt Rubens <[email protected]>
Co-authored-by: Hannes Rudolph <[email protected]>

Author: 5 people

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

@@ -13,86 +13,34 @@ image: /img/social-share.jpg
 ---
 import KangarooIcon from '@site/src/components/KangarooIcon';
 
-# Connecting Your First AI Provider
+# Connecting Your First LLM Provider
 
-Roo Code requires an API key from an AI model provider to function. We recommend these options for accessing the powerful **Claude Sonnet 4.5** model:
+Roo Code needs an inference provider to access the LLM models that make it work.
 
-- **OpenRouter (Recommended):** Provides access to multiple AI models through a single API key. Ideal for getting started quickly with minimal setup. [View pricing](https://openrouter.ai/models?order=pricing-low-to-high).
-- **Anthropic:** Direct access to Claude models. Requires API access approval and may have [rate limits depending on your tier](https://docs.anthropic.com/en/api/rate-limits#requirements-to-advance-tier). See [Anthropic's pricing page](https://www.anthropic.com/pricing#anthropic-api) for details.
+A great model to start is **Claude Sonnet 4.5**, which offers a lot of power at a reasonable price point. To get it going, choose a provider:
 
----
-
-## Getting Your API Key
-
-### Option 1: LLM Routers
-
-LLM routers let you access multiple AI models with one API key, simplifying cost management and switching between models. They often offer [competitive pricing](https://openrouter.ai/models?order=pricing-low-to-high) compared to direct providers.
-
-#### OpenRouter
-
-1. Go to [openrouter.ai](https://openrouter.ai/)
-2. Sign in with your Google or GitHub account
-3. Navigate to the [API keys page](https://openrouter.ai/keys) and create a new key
-4. Copy your API key - you'll need this for Roo Code setup
-
-<img src="/img/connecting-api-provider/connecting-api-provider-4.png" alt="OpenRouter API keys page" width="600" />
-
-*OpenRouter dashboard with "Create key" button. Name your key and copy it after creation.*
-
-#### Requesty
-
-1. Go to [requesty.ai](https://requesty.ai/)
-2. Sign in with your Google account or email
-3. Navigate to the [API management page](https://app.requesty.ai/api-keys) and create a new key
-4. **Important:** Copy your API key immediately as it won't be displayed again
-
-<img src="/img/connecting-api-provider/connecting-api-provider-7.png" alt="Requesty API management page" width="600" />
-
-*Requesty API management page with "Create API Key" button. Copy your key immediately - it's shown only once.*
+- **Roo Code Cloud Provider (Recommended):** the easiest way to access multiple providers tested with Roo Code. No API needed. To get started, just choose Roo Code Cloud as a provider and follow instructions. [Learn more about it](/roo-code-provider/overview).
 
-### Option 2: Direct Providers
+- **OpenRouter:** Provides access to multiple AI models from different labs through a single API key. Great for flexibility and getting started reasonably fast. To get an API key, [follow these instructions <LucideIcon name="ArrowRight" />](/providers/openrouter#getting-an-api-key)
 
-For direct access to specific models from their original providers, with full access to their features and capabilities:
+- **Anthropic:** Direct access to the Claude family of models. Requires API access approval and may have [rate limits depending on your tier](https://docs.anthropic.com/en/api/rate-limits#requirements-to-advance-tier).  To get an API key, [follow these instructions <LucideIcon name="ArrowRight" />](/providers/anthropic#getting-an-api-key)
 
-#### Anthropic
+Roo Code is compatible with [other providers](/providers/index) which offer Claude, and with a wide range of different models you can try.
 
-1. Go to [console.anthropic.com](https://console.anthropic.com/)
-2. Sign up for an account or log in
-3. Navigate to the [API keys section](https://console.anthropic.com/settings/keys) and create a new key
-4. **Important:** Copy your API key immediately as it won't be displayed again
-
-<img src="/img/connecting-api-provider/connecting-api-provider-5.png" alt="Anthropic console API Keys section" width="600" />
-
-*Anthropic console API Keys section with "Create key" button. Name your key, set expiration, and copy it immediately.*
-
-#### OpenAI
-
-1. Go to [platform.openai.com](https://platform.openai.com/)
-2. Sign up for an account or log in
-3. Navigate to the [API keys section](https://platform.openai.com/api-keys) and create a new key
-4. **Important:** Copy your API key immediately as it won't be displayed again
-
-<img src="/img/connecting-api-provider/connecting-api-provider-6.png" alt="OpenAI API keys page" width="600" />
+:::info Model Selection Advice
+We recommend **Claude Sonnet 4.5** because it "just works" out of the box for most tasks. We use it internally a lot.
 
-*OpenAI platform with "Create new secret key" button. Name your key and copy it immediately after creation.*
+You can choose other models, but that introduces complexity. Different models vary in how they follow tool instructions, parse formats, and maintain context through multi-step operations, so it may be better to try them later. If you do experiment with other models, choose ones specifically designed for structured reasoning and tool use.
+:::
 
 ---
 
-## Configuring Roo Code in VS Code
-
-Once you have your API key:
-
-1. Open the Roo Code sidebar by clicking the Roo Code icon (<KangarooIcon />) in the VS Code Activity Bar
-2. In the welcome screen, select your API provider from the dropdown
-3. Paste your API key into the appropriate field
-4. Select your model:
-   - For **OpenRouter**: select `anthropic/claude-sonnet-4-5` ([model details](https://openrouter.ai/anthropic/claude-sonnet-4-5))
-   - For **Anthropic**: select `claude-sonnet-4-5` ([model details](https://www.anthropic.com/pricing#anthropic-api))
+## Configuring the provider in VS Code
 
-:::info Model Selection Advice
-We strongly recommend **Claude Sonnet 4.5** 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.
-:::
+1. Open the Roo Code panel by clicking the Roo Code icon (<KangarooIcon />) in the VS Code Activity Bar
+2. In the welcome screen, choose your LLM provider.
+3. If you choose the Roo Code Cloud provider, just connect your account and choose `anthropic/claude-sonnet-4-5` from the dropdown. You're set.
+4. If you chose another provider, paste the API key you copied from it into the right field and continue
+5. Select your model (it should be called `claude-sonnet-4-5` or `anthropic/claude-sonnet-4-5`) and complete the process.
 
-5. Click "Let's go!" to save your settings and start using Roo Code
+Now you can start coding!

docs/getting-started/your-first-task.md

@@ -11,7 +11,7 @@ image: /img/social-share.jpg
 ---
 import KangarooIcon from '@site/src/components/KangarooIcon';
 
-# Starting Your First Task with Roo Code
+# Your first task
 
 Now that you've [configured your AI provider and model](/getting-started/connecting-api-provider), you're ready to start using Roo Code! This guide walks you through your first interaction.
 
@@ -21,11 +21,10 @@ Now that you've [configured your AI provider and model](/getting-started/connect
 
 Click the Roo Code icon (<KangarooIcon />) in the VS Code Activity Bar (vertical bar on the side of the window) to open the chat interface. If you don't see the icon, verify the extension is installed and enabled.
 
-<img src="/img/your-first-task/your-first-task.png" alt="Roo Code icon in VS Code Activity Bar" width="800" />
-
-*The Roo Code icon in the Activity Bar opens the chat interface.*
-
----
+<figure>
+  <img src="/img/your-first-task/your-first-task.png" alt="Roo Code icon in VS Code Activity Bar" width="600" />
+  <figcaption>The Roo Code icon in the Activity Bar opens the chat interface. You can drag it to position Roo elsewhere.</figcaption>
+</figure>
 
 ## Step 2: Type Your Task
 
@@ -37,17 +36,15 @@ Type a clear, concise description of what you want Roo Code to do in the chat bo
 
 No special commands or syntax needed—just use plain English.
 
-<img src="/img/your-first-task/your-first-task-6.png" alt="Typing a task in the Roo Code chat interface" width="500" />
-*Enter your task in natural language - no special syntax required.*
-
----
+<figure>
+  <img src="/img/your-first-task/your-first-task-6.png" alt="Typing a task in the Roo Code chat interface" width="400" />
+  <figcaption>Enter your task in natural language - no special syntax required.</figcaption>
+</figure>
 
 ## Step 3: Send Your Task
 
 Press Enter or click the Send icon (<Codicon name="send" />) to the right of the input box.
 
----
-
 ## Step 4: Review and Approve Actions
 
 Roo Code analyzes your request and proposes specific actions. These may include:
@@ -58,22 +55,26 @@ Roo Code analyzes your request and proposes specific actions. These may include:
 * **Using the Browser:** Outlines browser actions (click, type, etc.)
 * **Asking questions:** Requests clarification when needed to proceed
 
-<img src="/img/your-first-task/your-first-task-7.png" alt="Reviewing a proposed file creation action" width="800" />
-*Roo Code shows exactly what action it wants to perform and waits for your approval.*
+
+<figure>
+  <img src="/img/your-first-task/your-first-task-7.png" alt="Reviewing a proposed file creation action" width="800" />
+  <figcaption>Roo Code shows exactly what action it wants to perform and waits for your approval.</figcaption>
+</figure>
 
 **Each action requires your explicit approval** (unless auto-approval is enabled):
 
 * **Approve:** Click the "Approve" button to execute the proposed action
 * **Reject:** Click the "Reject" button and provide feedback if needed
 
----
 
 ## Step 5: Iterate
 
 Roo Code works iteratively. After each action, it waits for your feedback before proposing the next step. Continue this review-approve cycle until your task is complete.
 
-<img src="/img/your-first-task/your-first-task-8.png" alt="Final result of a completed task showing the iteration process" width="500" />
-*After completing the task, Roo Code shows the final result and awaits your next instruction.*
+<figure>
+  <img src="/img/your-first-task/your-first-task-8.png" alt="Final result of a completed task showing the iteration process" width="500" />
+  <figcaption>After completing the task, Roo Code shows the final result and awaits your next instruction.</figcaption>
+</figure>
 
 ---
 

docs/providers/index.mdx

@@ -18,7 +18,7 @@ The Roo Code VS Code extension and Roo Code Cloud Agents are highly capable, sop
 
 Other tools are intinsically bound by design to a specific provider (like Claude Code → Anthropic Models or Codex → OpenAI models), forcing you to stick with them irrespective of how the landscape changes (which happens fast). Roo on the other hand is **model-agnostic**, allowing you to choose the model that best fits your needs, according to your budget, skill profile, codebase and more.
 
-So we support connting to a wide range of model providers, giving you flexibility in how you access AI models. Some providers work with the VS Code extension, while others are available through Roo Code Cloud Agents.
+We support connecting to a wide range of model providers, giving you flexibility in how you access AI models. Some providers work with the VS Code extension, while others are available through Roo Code Cloud Agents.
 
 Learn how to set up your provider in [the Roo Code VS Code extension here](/getting-started/connecting-api-provider).
 
@@ -37,4 +37,4 @@ Yeah, it's a lot.
 - **Want it to JustWork™?** Go with the [Roo Code Cloud Provider](/roo-code-provider/overview) for a curated selection and the easiest setup with no API keys required
 - **Want access to many models?** Try [OpenRouter](/providers/openrouter) for a single API to 100+ models
 - **Want to optimize for specific models?** Use the first part provider for each of them (Anthropic, OpenAI, etc)
-- **Looking for local/offline models?** Check out [Ollama](/providers/ollama) or [LM Studio](/providers/lmstudio)
+- **Looking for local/offline models?** Check out [Ollama](/providers/ollama) or [LM Studio](/providers/lmstudio)

docs/providers/roo-code-cloud.md

@@ -4,8 +4,6 @@ description: The easiest way to get started with AI coding. Access premium model
 keywords:
   - roo code cloud
   - roo provider
-  - grok-code-fast-1
-  - code-supernova
   - free ai models
   - easy setup
   - no api key
@@ -14,71 +12,13 @@ image: /img/social-share.jpg
 
 # Roo Code Cloud Provider
 
-**The Easiest Way to Get Started with AI Coding**
+To make it as smooth as possible to use Roo Code, which depends on a provider service for LLM inference, we've built the Roo Code Cloud Provider.
 
-Roo Code Cloud removes the complexity of setting up AI providers. Forget about API keys, credit cards, and complex configuration. Just sign in and start coding with premium models for **FREE**.
+There's no need for a separate subscription or managing API keys. It's fully integrated into our suite of products and easy to get started. It features:
 
-[Learn more about the provider here.](/roo-code-provider/overview)
+- Both free and paid models
+- Only models tested to work well with Roo
+- Paid models provided at cost, with no mark-up
+- The same pre-paid credit mechanism you'll use for Roo Code Cloud Agents
 
-## Why Choose Roo Code Cloud?
-
-- **Zero Configuration**: No API keys to manage. Just sign in with GitHub, Google, or email.
-- **No Credit Card Required**: Get started immediately without entering payment details.
-- **Free Premium Models**: Access powerful models like `grok-code-fast-1` and `code-supernova` at no cost during our promotional period.
-- **Instant Access**: Start coding in seconds.
-
-## Available Models
-
-We curate the best models for coding and offer them directly to you.
-
-### grok-code-fast-1
-*(Formerly roo/sonic)*
-- **Best for:** Fast coding, quick edits, and high-speed iterations.
-- **Speed:** Extremely Fast
-- **Context:** 262k tokens
-- **Pricing:** **FREE** (Promotional)
-
-### roo/code-supernova
-- **Best for:** Complex reasoning, multimodal tasks (images), and deep architectural planning.
-- **Capabilities:** Supports image analysis (multimodal).
-- **Context:** 200k tokens
-- **Pricing:** **FREE** (Promotional)
-
-## How to Connect
-
-1. **Sign In**: Click the account icon (<Codicon name="account" />) in the Roo Code extension sidebar and sign in. See [Connect Guide](/roo-code-cloud/connect) if needed.
-2. **Select Provider**:
-   - Open Settings (<Codicon name="gear" />).
-   - In the **API Provider** dropdown, select **Roo Code Cloud**.
-3. **Start Coding**: Choose your model and start your first task!
-
-## Pricing & Credits
-
-Roo Code Cloud operates on a [Credit System](/roo-code-cloud/billing-subscriptions).
-- **Promotional Period**: Currently, all standard usage for the models listed above is **100% FREE**.
-- **Future Pricing**: We will introduce a transparent credit-based system for usage beyond the free tier. You will always be notified before any charges apply.
-
-:::info
-Within Roo Code, free access is only through Roo Code Cloud provider. Using the [xAI provider](/providers/xai) for `grok-code-fast-1` will incur standard charges once pricing is established.
-:::
-
-## Comparison with Other Providers
-
-| Feature | Roo Code Cloud | Direct Providers (OpenAI/Anthropic/xAI) |
-| :--- | :--- | :--- |
-| **Setup** | One-click Sign In | Requires API Keys |
-| **Payment** | Free (Promo) / Credits | Credit Card / Monthly Bill |
-| **Configuration** | Automatic | Manual |
-| **Model Selection** | Curated Best-in-Class | All Available Models |
-
-## Troubleshooting
-
-**"Authentication required"**: Connect to Roo Code Cloud via the account icon.
-
-**"No session token"**: Sign out and back in to refresh your session.
-
-**Connection issues**: Check internet connection and restart VS Code if needed.
-
----
-
-[Get Started Now](/roo-code-cloud/connect)
+[Learn more and how to get started <LucideIcon name="ArrowRight" />](/roo-code-provider/overview)

docs/roo-code-cloud/billing-subscriptions.mdx

@@ -18,10 +18,12 @@ image: /img/social-share.jpg
 
 Cloud Agents are specialized, autonomous AI workers that run in the cloud.
 
-It upends the way most people think about software development: instead of a highly specialized activity that can only happen in a specialized IDE, it encapsulates the relevant aspects of each part of the process into agents that can run on their own (but will take your guidance if you choose).
+They upend the way most people think about software development: instead of a highly specialized activity that can only happen in a specialized IDE, it encapsulates the relevant aspects of each part of the process into agents that can run on their own (but will take your guidance if you choose).
 
 In other words: instead of doing all of your learning, investigating, coding, testing and shipping from your IDE, you can delegate work to focused agents which operate as a team. And it's your choice how much you lean into it.
 
+Cloud Agents are available in all Roo Code Cloud plans, including the free one.
+
 Sounds like wishful thinking? Read on and we'll show you how to use them.
 
 ---