Skip to content

Commit db8bed0

Browse files
continue[bot]ContinueUsername
authored andcommitted
Consolidate duplicate documentation paths from /customization/ to /customize/
This consolidation addresses CON-4476 by eliminating confusing duplicate documentation paths. ## Changes Made ### Structure Consolidation - Removed /docs/customization/ directory entirely - Kept /docs/customize/ as the single canonical path (it contains comprehensive content including deep-dives, model-providers, and model-roles) - Moved better overview content from /customization/overview.mdx to /customize/overview.mdx - Added new top-level pages to /customize/: models.mdx, mcp-tools.mdx, rules.mdx, prompts.mdx, settings.mdx ### Navigation Updates - Removed duplicate "Customization" tab from docs.json navigation - Updated "Customize" tab to include the new top-level pages - All customization content now appears in a single, well-organized tab ### Redirects - Added redirects from all /customization/* paths to /customize/* - Ensures backward compatibility for bookmarks and external links - Updated existing redirects that pointed to /customization/overview ### Link Updates - Updated 16+ internal documentation links from /customization/ to /customize/ - Updated image paths from /images/customization/ to /images/customize/ - Consolidated image directories (removed /docs/images/customization/) ## Reasoning for Content Decisions ### Why Keep /customize/ Over /customization/? 1. More concise - Shorter path is easier to type and remember 2. Complete structure - Already contained extensive subdirectories (deep-dives/, model-providers/, model-roles/) 3. Active development - Model provider docs and deep-dives are actively maintained here 4. Better organization - Clear hierarchy with specialized subdirectories ### Content Consolidation Strategy - Overview page: Used /customization/overview.mdx as base (clearer introduction and practical examples) - New pages: Brought over /customization/ files that provided good card-based overviews for models, rules, prompts, MCP, and settings - Deep-dives: Kept existing comprehensive /customize/deep-dives/ content (no overlap with /customization/) - Model providers: Kept existing /customize/model-providers/ (no equivalent in /customization/) - Model roles: Kept existing /customize/model-roles/ (no equivalent in /customization/) ### Deleted Content Justification All files from /docs/customization/ were either: 1. Duplicates with less comprehensive content than /customize/ equivalents 2. Moved to /customize/ to serve as helpful overview pages 3. No unique information lost - content was either redundant or merged ## Success Metrics Addressed - Zero duplicate documentation paths - All internal links functional (verified) - Clear single source of truth for customization - Backward compatibility via redirects Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <noreply@continue.dev> Co-authored-by: Username <nate@continue.dev>
1 parent 6f992b7 commit db8bed0

29 files changed

+75
-112
lines changed

docs/customization/overview.mdx

Lines changed: 0 additions & 35 deletions
This file was deleted.

docs/customize/deep-dives/custom-providers.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -184,7 +184,7 @@ You'll then be able to type "@" and see "MCP" in the context providers dropdown.
184184

185185
<Note>
186186
To provide conext beyond the built-in context providers, we now recommend
187-
using [MCP Servers](/customization/mcp-tools)
187+
using [MCP Servers](/customize/mcp-tools)
188188
</Note>
189189

190190
View the [deprecated context providers](/reference/deprecated-context-providers) for documentation on:

docs/customization/mcp-tools.mdx renamed to docs/customize/mcp-tools.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ These servers make it possible to:
1313
- **Allow partners** to contribute specialized functionality
1414
- **Connect to databases** to understand schema and data models during development
1515

16-
![MCP servers overview](/images/customization/images/mcp-blocks-overview-c9a104f9b586779c156f9cf34da197c2.png)
16+
![MCP servers overview](/images/customize/images/mcp-blocks-overview-c9a104f9b586779c156f9cf34da197c2.png)
1717

1818
## Learn More About MCP servers
1919

docs/customize/model-roles/00-intro.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Models in Continue can be configured to be used for various roles in the extensi
1818
These roles can be specified for a `config.yaml` model block using `roles`. See the [YAML Specification](/reference#models) for more details.
1919

2020
<Info>
21-
For recommendations on which models work best for each role, see our [comprehensive model recommendations](/customization/models#recommended-models).
21+
For recommendations on which models work best for each role, see our [comprehensive model recommendations](/customize/models#recommended-models).
2222
</Info>
2323

2424
## Selecting model roles

docs/customize/model-roles/apply.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ When editing code, Chat and Edit model output often doesn't clearly align with e
1010
## Recommended Apply models
1111

1212
<Info>
13-
For the latest Apply model recommendations, see our [comprehensive model recommendations](/customization/models#recommended-models).
13+
For the latest Apply model recommendations, see our [comprehensive model recommendations](/customize/models#recommended-models).
1414
</Info>
1515

1616
We recommend [Morph Fast Apply](https://morphllm.com) or [Relace's Instant Apply model](https://hub.continue.dev/relace/instant-apply) for the fastest Apply experience. You can sign up for Morph's free tier [here](https://morphllm.com/dashboard) or get a Relace API key [here](https://app.relace.ai/settings/api-keys).

docs/customize/model-roles/embeddings.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ You can add `embed` to a model's `roles` to specify that it can be used to embed
2020
## Recommended embedding models
2121

2222
<Info>
23-
See our [comprehensive model recommendations](/customization/models#recommended-models) for the best embedding models comparison.
23+
See our [comprehensive model recommendations](/customize/models#recommended-models) for the best embedding models comparison.
2424
</Info>
2525

2626
If you have the ability to use any model, we recommend `voyage-code-3`, which is listed below along with the rest of the options for embeddings models.

docs/customize/model-roles/reranking.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ In Continue, rerankers are designated using the `rerank` role and used by [codeb
1212
## Recommended reranking models
1313

1414
<Info>
15-
For a comparison of all reranking models including open and closed options, see our [comprehensive model recommendations](/customization/models#recommended-models).
15+
For a comparison of all reranking models including open and closed options, see our [comprehensive model recommendations](/customize/models#recommended-models).
1616
</Info>
1717

1818
If you have the ability to use any model, we recommend `rerank-2` by Voyage AI, which is listed below along with the rest of the options for rerankers.

docs/customization/models.mdx renamed to docs/customize/models.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ import { ModelRecommendations } from "/snippets/ModelRecommendations.jsx";
1212
- **[Embedding](/customize/model-roles/embeddings)**: Transform code into vector representations for semantic search
1313
- **[Reranker](/customize/model-roles/reranking)**: Improve search relevance by ordering results based on semantic meaning
1414

15-
![Models Overview](/images/customization/images/model-blocks-overview-36c30e7e01928d7a9b5b26ff1639c34b.png)
15+
![Models Overview](/images/customize/images/model-blocks-overview-36c30e7e01928d7a9b5b26ff1639c34b.png)
1616

1717
## Recommended Models
1818

docs/customize/overview.mdx

Lines changed: 18 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,35 @@
11
---
2-
title: "Overview"
3-
description: "Explore Continue's advanced capabilities for power users and complex development scenarios."
2+
title: "Customization Overview"
3+
description: "Learn how to customize Continue with model providers, slash commands, and tools"
44
---
55

6-
## Context Integration
6+
Continue can be deeply customized to fit your specific development workflow and preferences. This guide covers the main ways you can customize Continue to enhance your coding experience.
77

8-
Specialized context features for codebase understanding and documentation integration.
8+
## Change Your Model Provider
99

10-
[Browse Context Features →](/guides/understanding-configs)
10+
Continue allows you to choose your favorite or even add multiple model providers. This allows you to use different models for different tasks, or to try another model if you're not happy with the results from your current model. Continue supports all of the popular model providers, including OpenAI, Anthropic, Microsoft/Azure, Mistral, and more. You can even self host your own model provider if you'd like. Learn more about [model providers](/customize/model-providers/overview).
1111

12-
## Deep Dives
12+
## Select Different Models for Specific Tasks
1313

14-
Detailed technical explanations of Continue's internal workings and advanced configuration options.
14+
Different Continue features can use different models. We call these _model roles_. For example, you can use a different model for Chat mode than you do for Autocomplete. Learn more about [model roles](/customize/model-roles).
1515

16-
[Read Deep Dives →](/customize/deep-dives/configuration)
16+
## Create a Slash Command
1717

18-
## Model Providers
18+
Slash commands allow you to easily add custom prompts to Continue. Learn more about [slash commands](/customize/deep-dives/prompts).
1919

20-
Configure and optimize different AI model providers for your specific needs and infrastructure.
20+
## Call External Tools and Functions
2121

22-
[Configure Providers →](/customize/model-providers/overview)
22+
Unchain your LLM with the power of tools using [Agent mode](/ide-extensions/agent/quick-start). Add custom tools using [MCP Servers](/customize/mcp-tools)
2323

24-
## Model Roles
24+
Whatever you choose, you'll probably start by editing your configuration.
2525

26-
Understand how different models can be assigned specific roles in your development workflow.
26+
## Edit Your Configuration
2727

28-
[Learn Model Roles →](/customize/model-roles)
28+
You can easily access your configuration from the Continue Chat sidebar. Open the sidebar by pressing `cmd/ctrl` + `L` (VS Code) or `cmd/ctrl` + `J` (JetBrains) and click the Agent selector above the main chat input. Then, you can hover over an agent and click the `new window` (hub agents) or `gear` (local agents) icon.
2929

30-
## Deep Dives
30+
![configure](/images/customize/images/configure-continue-a5c8c79f3304c08353f3fc727aa5da7e.png)
3131

32-
Detailed technical explanations of Continue's internal workings and advanced configuration options.
32+
## Manage Your Configuration
3333

34-
[Read Deep Dives →](/customization/overview#configuration)
35-
36-
## Reference
37-
38-
Complete configuration reference and API documentation.
39-
40-
[View Reference →](/reference)
41-
42-
## Troubleshooting
43-
44-
Solutions to common issues and debugging techniques.
45-
46-
[Get Help →](/troubleshooting)
47-
48-
---
49-
50-
These advanced topics help you get the most out of Continue in complex development environments.
34+
- See [Editing Hub Configurations](/hub/configs/edit-a-config) for more details on managing your hub configuration
35+
- See the [Config Deep Dive](/reference) for more details on local configurations

docs/customization/prompts.mdx renamed to docs/customize/prompts.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ description: "These are the specialized instructions that shape how models respo
99
- **Can be shared and reused** across multiple assistants
1010
- **Act as automated code reviewers** that ensure consistency across teams
1111

12-
![Prompts Overview](/images/customization/images/prompts-blocks-overview-17194d870840576f9a0dde548f2c70ec.png)
12+
![Prompts Overview](/images/customize/images/prompts-blocks-overview-17194d870840576f9a0dde548f2c70ec.png)
1313

1414
## Learn More
1515

0 commit comments

Comments
 (0)