Changed layout of menu and sections and updated linked throughout

Author: hannesrudolph

docs/advanced-usage/custom-modes.md

@@ -287,4 +287,4 @@ Roo will generate the appropriate pattern with proper escaping for JSON configur
 
 ## Community Gallery
 
-Ready to explore more? Check out the [Custom Modes Gallery](/community#custom-modes-gallery) to discover and share custom modes created by the community!
+Ready to explore more? Check out the [Custom Modes Gallery](../community#custom-modes-gallery) to discover and share custom modes created by the community!

docs/advanced-usage/local-models.md

@@ -24,9 +24,8 @@ Roo Code currently supports two main local model providers:
 ## Setting Up Local Models
 
 For detailed setup instructions, see:
-
-* [Setting up Ollama](/providers/ollama)
-* [Setting up LM Studio](/providers/lmstudio)
+* [Setting up Ollama](../providers/ollama)
+* [Setting up LM Studio](../providers/lmstudio)
 
 Both providers offer similar capabilities but with different user interfaces and workflows. Ollama provides more control through its command-line interface, while LM Studio offers a more user-friendly graphical interface.
 

docs/advanced-usage/mcp.md

@@ -5,4 +5,4 @@ sidebar_label: MCP
 
 import {Redirect} from '@docusaurus/router';
 
-<Redirect to="/mcp/using-mcp-in-roo" />
+<Redirect to="../mcp/using-mcp-in-roo" />

docs/advanced-usage/rate-limits-costs.md

@@ -46,6 +46,6 @@ If you set the rate limit to 10 seconds, Roo Code will wait at least 10 seconds
 *   **Use Custom Instructions:**  Provide custom instructions to guide Roo Code's behavior and reduce the need for lengthy explanations in each prompt.
 *   **Choose the Right Model:**  Some models are more cost-effective than others.  Consider using a smaller, faster model for tasks that don't require the full power of a larger model.
 *   **Use Modes:** Different modes can access different tools, for example `Architect` can't modify code, which makes it a safe choice when analyzing a complex codebase, without worrying about accidentally allowing expensive operations.
-*   **Disable MCP If Not Used:** If you're not using MCP (Model Context Protocol) features, consider [disabling it in the MCP settings](/mcp/using-mcp-in-roo#enabling-or-disabling-mcp-server-creation) to significantly reduce the size of the system prompt and save tokens.
+*   **Disable MCP If Not Used:** If you're not using MCP (Model Context Protocol) features, consider [disabling it in the MCP settings](../mcp/using-mcp-in-roo#enabling-or-disabling-mcp-server-creation) to significantly reduce the size of the system prompt and save tokens.
 
 By understanding and managing your API usage, you can use Roo Code effectively and efficiently.

docs/faq.md

@@ -53,58 +53,50 @@ See the [Installation Guide](getting-started/installing) for detailed instructio
 ### 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)
+*   [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)
 
 ### 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.
+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.
 
 ### 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.
+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
 
 ### How do I start a new task?
-
-Open the Roo Code panel (<Codicon name="rocket" />) 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.
+Open the Roo Code panel (<Codicon name="rocket" />) 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.
 
 ### What are modes in Roo Code?
-
-[Modes](/basic-usage/using-modes) are different personas that Roo Code can adopt, each with a specific focus and set of capabilities. The built-in modes are:
+[Modes](basic-usage/using-modes) are different personas that Roo Code can adopt, each with a specific focus and set of capabilities. The built-in modes are:
 
 *   **Code:** For general-purpose coding tasks.
 *   **Architect:** For planning and technical leadership.
 *   **Ask:** For answering questions and providing information.
 *   **Debug:** For systematic problem diagnosis.
-
-You can also create [Custom Modes](/advanced-usage/custom-modes).
+You can also create [Custom Modes](advanced-usage/custom-modes).
 
 ### How do I switch between modes?
 
 Use the dropdown menu in the chat input area to select a different mode, or use the `/` command to switch to a specific mode.
 
 ### What are tools and how do I use them?
-
-[Tools](/basic-usage/how-tools-work) are how Roo Code interacts with your system.  Roo Code automatically selects and uses the appropriate tools to complete your tasks. You don't need to call tools directly. You will be prompted to approve or reject each tool use.
+[Tools](basic-usage/how-tools-work) are how Roo Code interacts with your system.  Roo Code automatically selects and uses the appropriate tools to complete your tasks. You don't need to call tools directly. You will be prompted to approve or reject each tool use.
 
 ### What are context mentions?
-
-[Context mentions](/basic-usage/context-mentions) are a way to provide Roo Code with specific information about your project, such as files, folders, or problems. Use the "@" symbol followed by the item you want to mention (e.g., `@/src/file.ts`, `@problems`).
+[Context mentions](basic-usage/context-mentions) are a way to provide Roo Code with specific information about your project, such as files, folders, or problems. Use the "@" symbol followed by the item you want to mention (e.g., `@/src/file.ts`, `@problems`).
 
 ### Can Roo Code access the internet?
 
@@ -128,16 +120,15 @@ Yes, you can customize Roo Code in several ways:
 *   **Settings:** Adjust various settings, such as auto-approval, diff editing, and more.
 
 ### Does Roo Code have any auto approval settings?
-Yes, Roo Code has a few settings that when enabled will automatically approve actions. Find out more [here](/advanced-usage/auto-approving-actions).
+Yes, Roo Code has a few settings that when enabled will automatically approve actions. Find out more [here](advanced-usage/auto-approving-actions).
 
 ## Advanced Features
 
 ### Can I use Roo offline?
-Yes, if you use a [local model](/advanced-usage/local-models).
+Yes, if you use a [local model](advanced-usage/local-models).
 
 ### What is MCP (Model Context Protocol)?
-
-[MCP](/advanced-usage/mcp) is a protocol that allows Roo Code to communicate with external servers, extending its capabilities with custom tools and resources.
+[MCP](advanced-usage/mcp) is a protocol that allows Roo Code to communicate with external servers, extending its capabilities with custom tools and resources.
 
 ### Can I create my own MCP servers?
 

docs/features/api-configuration-profiles.md

@@ -0,0 +1,76 @@
+# API Configuration Profiles
+
+API Configuration Profiles allow you to create and switch between different sets of AI settings. Each profile can have different configurations for each mode, letting you optimize your experience based on the task at hand.
+
+:::info
+Having multiple configuration profiles lets you quickly switch between different AI providers, models, and settings without reconfiguring everything each time you want to change your setup.
+:::
+## How It Works
+
+Configuration profiles can have their own:
+- API providers (OpenAI, Anthropic, OpenRouter, Glama, etc.)
+- API keys and authentication details
+- Model selections (o3-mini-high, Claude 3.7 Sonnet, DeepSeek R1, etc.)
+- [Temperature settings](./model-temperature) for controlling response randomness
+- Thinking budgets
+- Provider-specific settings
+
+Note that available settings vary by provider and model. Each provider offers different configuration options, and even within the same provider, different models may support different parameter ranges or features.
+
+## Creating and Managing Profiles
+
+### Creating a Profile
+
+1. Open Settings by clicking the gear icon <Codicon name="gear" /> → Providers
+2. Click the "+" button next to the profile selector
+
+   <img src="/img/api-configuration-profiles/api-configuration-profiles-1.png" alt="Profile selector with plus button" width="550" />
+3. Enter a name for your new profile
+   
+   <img src="/img/api-configuration-profiles/api-configuration-profiles.png" alt="Creating a new profile dialog" width="550" />
+4. Configure the profile settings:
+   - Select your API provider
+      
+      <img src="/img/api-configuration-profiles/api-configuration-profiles-2.png" alt="Provider selection dropdown" width="550" />
+   - Enter API key
+   
+      <img src="/img/api-configuration-profiles/api-configuration-profiles-3.png" alt="API key entry field" width="550" />
+   - Choose a model
+   
+      <img src="/img/api-configuration-profiles/api-configuration-profiles-8.png" alt="Model selection interface" width="550" />
+   - Adjust model parameters
+   
+      <img src="/img/api-configuration-profiles/api-configuration-profiles-5.png" alt="Model parameter adjustment controls" width="550" />
+
+### Switching Profiles
+
+Switch profiles in two ways:
+1. From Settings panel: Select a different profile from the dropdown
+
+   <img src="/img/api-configuration-profiles/api-configuration-profiles-7.png" alt="Profile selection dropdown in Settings" width="550" />
+2. During chat: Access the API Configuration dropdown in the chat interface
+
+   <img src="/img/api-configuration-profiles/api-configuration-profiles-9.png" alt="API Configuration dropdown in chat interface" width="550" />
+
+### Editing and Deleting Profiles
+
+<img src="/img/api-configuration-profiles/api-configuration-profiles-10.png" alt="Profile editing interface" width="550" />
+- Select the profile in Settings to modify any settings
+- Click the pencil icon to rename a profile
+- Click the trash icon to delete a profile (you cannot delete the only remaining profile)
+
+## Linking Profiles to Modes
+In the <Codicon name="notebook" /> Prompts tab, you can explicitly associate a specific Configuration Profile with each Mode. The system also automatically remembers which profile you last used with each mode, making your workflow more efficient.
+<img src="/img/api-configuration-profiles/api-configuration-profiles-11.png" alt="Profile-Mode association interface in Prompts tab" width="550" />
+
+## Security Note
+
+API keys are stored securely in VSCode's Secret Storage and are never exposed in plain text.
+
+## Related Features
+
+- Works with [custom modes](./custom-modes) you create
+- Integrates with [local models](../../advanced-usage/local-models) for offline work
+- Supports [temperature settings](./model-temperature) per mode
+- Enhances cost management with [rate limits and usage tracking](../../advanced-usage/rate-limits-costs)
+