Commit db8bed0
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
File tree
29 files changed
+75
-112
lines changed- docs
- customization
- customize
- deep-dives
- model-roles
- guides
- ide-extensions
- agent
- autocomplete
- chat
- edit
- images
- customization/images
- customize
- assets/images
- images
29 files changed
+75
-112
lines changedThis file was deleted.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
184 | 184 | | |
185 | 185 | | |
186 | 186 | | |
187 | | - | |
| 187 | + | |
188 | 188 | | |
189 | 189 | | |
190 | 190 | | |
| |||
Lines changed: 1 addition & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
13 | 13 | | |
14 | 14 | | |
15 | 15 | | |
16 | | - | |
| 16 | + | |
17 | 17 | | |
18 | 18 | | |
19 | 19 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
18 | 18 | | |
19 | 19 | | |
20 | 20 | | |
21 | | - | |
| 21 | + | |
22 | 22 | | |
23 | 23 | | |
24 | 24 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
10 | 10 | | |
11 | 11 | | |
12 | 12 | | |
13 | | - | |
| 13 | + | |
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
20 | 20 | | |
21 | 21 | | |
22 | 22 | | |
23 | | - | |
| 23 | + | |
24 | 24 | | |
25 | 25 | | |
26 | 26 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
12 | 12 | | |
13 | 13 | | |
14 | 14 | | |
15 | | - | |
| 15 | + | |
16 | 16 | | |
17 | 17 | | |
18 | 18 | | |
| |||
Lines changed: 1 addition & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
12 | 12 | | |
13 | 13 | | |
14 | 14 | | |
15 | | - | |
| 15 | + | |
16 | 16 | | |
17 | 17 | | |
18 | 18 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | | - | |
3 | | - | |
| 2 | + | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | | - | |
| 6 | + | |
7 | 7 | | |
8 | | - | |
| 8 | + | |
9 | 9 | | |
10 | | - | |
| 10 | + | |
11 | 11 | | |
12 | | - | |
| 12 | + | |
13 | 13 | | |
14 | | - | |
| 14 | + | |
15 | 15 | | |
16 | | - | |
| 16 | + | |
17 | 17 | | |
18 | | - | |
| 18 | + | |
19 | 19 | | |
20 | | - | |
| 20 | + | |
21 | 21 | | |
22 | | - | |
| 22 | + | |
23 | 23 | | |
24 | | - | |
| 24 | + | |
25 | 25 | | |
26 | | - | |
| 26 | + | |
27 | 27 | | |
28 | | - | |
| 28 | + | |
29 | 29 | | |
30 | | - | |
| 30 | + | |
31 | 31 | | |
32 | | - | |
| 32 | + | |
33 | 33 | | |
34 | | - | |
35 | | - | |
36 | | - | |
37 | | - | |
38 | | - | |
39 | | - | |
40 | | - | |
41 | | - | |
42 | | - | |
43 | | - | |
44 | | - | |
45 | | - | |
46 | | - | |
47 | | - | |
48 | | - | |
49 | | - | |
50 | | - | |
| 34 | + | |
| 35 | + | |
Lines changed: 1 addition & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
9 | 9 | | |
10 | 10 | | |
11 | 11 | | |
12 | | - | |
| 12 | + | |
13 | 13 | | |
14 | 14 | | |
15 | 15 | | |
| |||
0 commit comments