Various updates and improvements (#445)

Author: brunobergher

docs/credits/overview.md

@@ -34,6 +34,12 @@ Model pricing can be found in the [provider page](https://roocode.com/provider)
 
 We don't include prices here just to make sure they're always up-to-date.
 
+## How do I get free credits or free minutes or free tokens?
+
+When you sign up for a Roo Code Cloud account, you'll be given a number of "Free Minutes" to try the product out (you'll see a cute <LucideIcon name="Gift" style={{ width: 14, position: "relative", top: 4}} /> icon). Those free minutes cover both the [Cloud Agent](/roo-code-cloud/cloud-agents) run time _and_ inference via the Roo Code Cloud provider (both of which normally cost credits). Those can't be used in the extension – they're there for you to try the magic of Cloud Agents.
+
+If you want free inference in the extension, choose a free model (or another provider which may offer it to you for free).
+
 ## How can I buy credits?
 
 ### Single purchase

docs/faq.md

@@ -23,18 +23,18 @@ This page answers some common questions about Roo Code.
 
 ### What is Roo Code?
 
-Roo Code is an AI-powered autonomous coding agent that lives in your editor.
+Roo Code is an AI-powered suite of coding products designed to take full advantage of the most advanced large-language models.
 
 ### How does Roo Code work?
 
 Roo Code uses large language models (LLMs) to understand your requests and translate them into actions.  It can:
 
-*   Read and write files in your project.
-*   Execute commands in your VS Code terminal.
-*   Perform web browsing (if enabled).
-*   Use external tools via the Model Context Protocol (MCP).
+- Read and write files in your project
+- Execute shell commands
+- Perform web browsing (if enabled)
+- Use external tools via the Model Context Protocol (MCP)
 
-You interact with Roo Code through a chat interface, where you provide instructions and review/approve its proposed actions.
+You interact with Roo Code through either a chat interface (in the Extension) or through different channels (in the Cloud).
 
 ### What can Roo Code do?
 
@@ -51,7 +51,11 @@ Roo Code can help with a variety of coding tasks, including:
 
 ### Is Roo Code free to use?
 
-The Roo Code extension itself is free and open-source. However, Roo Code relies on external API providers (like [Anthropic](providers/anthropic), [OpenAI](providers/openai), [OpenRouter](providers/openrouter), [Requesty](providers/requesty), etc.) for its AI capabilities.  These providers typically charge for API usage based on the number of tokens processed.  You will need to create an account and obtain an API key from your chosen provider.  See [Setting Up Your First AI Provider](getting-started/connecting-api-provider) for details.
+The Roo Code Extension is free and [open-source](https://github.com/RooCodeInc/Roo-Code/).
+The Roo Code Cloud platform is also free, but some functionality is paid.
+
+In both cases, Roo Code relies on external LLM inference providers (like [Anthropic](providers/anthropic), [OpenAI](providers/openai), [OpenRouter](providers/openrouter), [Requesty](providers/requesty), etc.) for its AI capabilities. We also offer [our own provider](/roo-code-provider/overview) as an alternative.
+These providers typically charge for API usage based on the number of tokens processed.  You will need to create an account and obtain an API key from your chosen provider. Learn more [about providers and how to set them up](/providers/) for details.
 
 ### What are the risks of using Roo Code?
 
@@ -71,31 +75,20 @@ See the [Installation Guide](/getting-started/installing) for detailed instructi
 
 ### Which API providers are supported?
 
-Roo Code supports a wide range of API providers, including:
-*   [Anthropic (Claude)](/providers/anthropic)
-*   [OpenAI](/providers/openai)
-*   [OpenRouter](/providers/openrouter)
-*   [Google Gemini](/providers/gemini)
-*   [Glama](/providers/glama)
-*   [AWS Bedrock](/providers/bedrock)
-*   [GCP Vertex AI](/providers/vertex)
-*   [Ollama](/providers/ollama)
-*   [LM Studio](/providers/lmstudio)
-*   [DeepSeek](/providers/deepseek)
-*   [Mistral](/providers/mistral)
-*   [Unbound](/providers/unbound)
-*   [Requesty](/providers/requesty)
-*   [VS Code Language Model API](/providers/vscode-lm)
+See the [full list here](/providers/).
 
 ### How do I get an API key?
+
 Each API provider has its own process for obtaining an API key.  See the [Setting Up Your First AI Provider](/getting-started/connecting-api-provider) for links to the relevant documentation for each provider.
 
+If you use the [Roo Code Cloud Provider](/roo-code-provider/overview), you don't need an API key.
+
 ### Can I use Roo Code with local models?
 Yes, Roo Code supports running models locally using [Ollama](/providers/ollama) and [LM Studio](/providers/lmstudio).  See [Using Local Models](/advanced-usage/local-models) for instructions.
 
 ---
 
-## Usage
+## Extension Usage
 
 ### How do I start a new task?
 Open the Roo Code panel (<KangarooIcon />) and type your task in the chat box. Be clear and specific about what you want Roo Code to do. See [Typing Your Requests](/basic-usage/typing-your-requests) for best practices.

docs/index.mdx

@@ -14,7 +14,9 @@ image: /img/social-share.jpg
 
 # Roo Code Docs
 
-Roo Code is an AI-coding suite of products designed to take full advantage of the most advanced large-language models and change how you create software at a fundamental level. It's unapologetically powerful and customizable, and it costs more to run than the alternatives because it uses frontier models with actual file system access, terminal control, and multi-step workflows. If you want the best AI coding experience available, this is it.
+Roo Code is an AI-coding suite of products designed to take full advantage of the most advanced large-language models and change how you create software at a fundamental level. It's unapologetically powerful and customizable, and it costs more to run than the alternatives because it uses frontier models with actual file system access, terminal control, and multi-step workflows.
+
+Roo's approach is to trade tokens for quality. If you want the best and most effective AI coding experience available, this is it.
 
 Roo Code is available in two ways:
 - [<LucideIcon name="Puzzle" style={{ width: "14px", position: "relative", top: 4 }} /> Roo Code VS Code Extension](/getting-started/installing) works locally in your VS Code IDE and gives you full control over your coding experience. It's great for deep or highly iterative solo development work. It's highly customizable and fits into your existing workflow.

docs/providers/index.mdx

@@ -20,10 +20,14 @@ Other tools are intinsically bound by design to a specific provider (like Claude
 
 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.
 
+Learn how to set up your provider in [the Roo Code VS Code extension here](/getting-started/connecting-api-provider).
+
 ## Provider Comparison
 
 Here's every provider we support and where you can use them. Click for detailed instructions.
 
+We regularly run evals for all supported models to see how they do against our standard test suite. [See the latest results here](https://roocode.com/evals).
+
 <ProviderTable />
 
 ## Overwhelmed by choice?
@@ -33,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/roo-code-provider/overview.md

@@ -41,6 +41,13 @@ best to check the privacy policy of the vendors themselves.
 
 You can always find the current pricing [on our website](https://roocode.com/provider) or the Roo Code Cloud app, under ["Models"](https://app.roocode.com/models).
 
+:::info Looking for free inference?
+When you sign up for a Roo Code Cloud account, you'll be given a number of "Free Minutes" to try the product out (you'll see a cute gift box icon). Those free minutes cover both the [Cloud Agent](/roo-code-cloud/cloud-agents) run time _and_ inference via the Roo Code Cloud provider (which, as we established, cost credits). Those can't be used in the extension.
+
+If you want free inference in the extension, choose a free model (or another provider which may offer it to you for free).
+:::
+
+
 ## How to use it
 
 ### Roo Code Cloud Agents

docs/update-notes/index.md

@@ -12,9 +12,14 @@ keywords:
 image: /img/social-share.jpg
 ---
 
-# Update Notes
+# Extension Release Notes
+
+See what's new in every release here.
+
+We release often, sometimes multiple times per day, so make sure to always be on the latest to have access to the most recent bug fixes and improvements.
+
+If you want to live on the edge and try things out before it's released, we have a [Nightly channel](https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-code-nightly).
 
- 
 ---
 
 ### Version 3.36

src/css/custom.css

@@ -1516,6 +1516,7 @@ a.breadcrumbs__link:hover,
 /* Override any article padding that might be adding space */
 article {
   padding-top: 0 !important;
+  
 }
 
 /* Target the main content container more specifically */
@@ -1793,6 +1794,7 @@ main[class*="docMainContainer"] {
   padding-left: 0.5em;
 }
 
+
 /* Category headers */
 .menu__list-item-collapsible {
   margin-bottom: 0;
@@ -1818,10 +1820,6 @@ main[class*="docMainContainer"] {
   background: none;
 }
 
-.menu__list_item .menu__link--active {
-  background: red !important;
-}
-
 /* TOC styling */
 .table-of-contents {
   padding: 0.5rem 0.75rem; /* Match left sidebar spacing */
@@ -1940,7 +1938,6 @@ html {
 
 /* Apply sidebar link styles */
 .menu__link {
-  font-size: 0.875rem;
   font-weight: 400;
   color: hsl(var(--muted-foreground));
   transition: all 200ms ease;
@@ -1955,7 +1952,6 @@ html {
 
 .menu__link--active {
   color: hsl(var(--foreground));
-  background: hsl(var(--background) / 0.7);
   font-weight: 500;
 }
 

src/theme/DocItem/Content/index.tsx

@@ -29,7 +29,7 @@ function useSyntheticTitle(): string | null {
 export default function DocItemContent({children}: Props): ReactNode {
   const syntheticTitle = useSyntheticTitle();
   return (
-    <div className={clsx(ThemeClassNames.docs.docMarkdown, 'markdown')}>
+    <div className={clsx(ThemeClassNames.docs.docMarkdown, 'markdown doc-container')}>
       {syntheticTitle && (
         <header>
           <Heading as="h1">{syntheticTitle}</Heading>