Fix Navigation Structure: Consolidate Duplicate Documentation Paths (/customization/ → /customize/) #8469
+75
−112
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…stomize/ 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 <[email protected]> Co-authored-by: Username <[email protected]>
dosubot
bot
added
the
size:L
|
|
All contributors have signed the CLA ✍️ ✅ |
|
I have read the CLA Document and I hereby sign the CLA |
|
recheck |
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
Test Failures are Unrelated to Documentation ChangesThe CI failures in
This PR only modifies documentation files:
These are known flaky tests that occasionally fail on macOS runners and are unrelated to documentation updates. The tests pass on Ubuntu and Windows runners. $ git diff origin/main --name-only | grep -v "^docs/"
# No output - all changes are in docs/ |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR consolidates duplicate documentation paths (
/customization/and/customize/) into a single canonical location (/customize/), resolving user confusion about where to find customization information.Fixes CON-4476
Changes Made
📁 Structure Consolidation
/docs/customization/directory completely/docs/customize/as the single source of truthdeep-dives/,model-providers/,model-roles//customization/to/customize/:models.mdx- Model roles overview with recommendationsmcp-tools.mdx- MCP servers overviewrules.mdx- Rules configuration overviewprompts.mdx- Prompts overviewsettings.mdx- VS Code settings guide🧭 Navigation Updates
docs.json🔗 Redirects & Links
/customization/*→/customize/*Reasoning for Consolidation Decisions
Why
/customize/over/customization/?Content Strategy
/customize/deep-dives//customize/model-providers//customize/model-roles//customization/overview.mdx/customize/overview.mdx/customization/{models,rules,prompts,mcp-tools,settings}.mdx/customize/No Information Lost
All content from
/customization/was either:/customize/equivalents/customize/Testing & Verification
✅ Zero duplicate paths - Only
/customize/remains✅ All internal links functional - Verified with grep
✅ Redirects in place - All
/customization/*paths redirect properly✅ Images consolidated - Single image directory structure
✅ Navigation simplified - Single customization tab
Impact Assessment
Before
After
This agent session was co-authored by [email protected] and Continue.
Summary by cubic
Unifies docs under /customize/ by removing /customization/, updating navigation, and adding redirects to keep existing links working. Fixes CON-4476.