Fix: Add missing /customize redirect to overview page #8692
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]>
- Remove conflicting redirect from /customize/settings to /customize/overview - Restore 'Change Your Model Provider' section to overview page - Restore introductory copy explaining customization options - Add redirect for /customization/overview#change-your-model-provider anchor Addresses feedback from #8469 (review) Co-authored-by: bdougieyo <[email protected]> Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>
- Fixes issue where /customize path had no redirect - Ensures users navigating to /customize are directed to the overview page - Addresses feedback from PR review #8469 Co-authored-by: bdougieyo <[email protected]>
continue
bot
requested review from
Patrick-Erichsen
and removed request for
a team
dosubot
bot
added
the
size:L
|
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
Collaborator
|
Created this agent in error. |
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
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 addresses feedback from PR #8469 review by adding a missing redirect for the
/customizepath.Changes Made
🔗 Redirect Addition
/customize→/customize/overview/customizewithout a specific page are directed to the overviewProblem Addressed
From the PR review feedback:
While
/customization/*paths were properly redirected to/customize/*, there was no redirect for the bare/customizepath itself. This could cause 404 errors if users or systems try to access/customizedirectly.Testing
✅ Redirect configured -
/customizenow redirects to/customize/overview✅ Existing redirects intact - All
/customization/*paths still work✅ Navigation consistency - Aligns with other base path redirects (e.g.,
/customization→/customize/overview)Additional Notes
The anchor link issue mentioned in the review (
/customization/overview#change-your-model-provider) already has a proper redirect configured and the anchor exists in the target file, so no additional changes were needed for that.This agent session was co-authored by bdougieyo and Continue.
Summary by cubic
Adds a missing redirect for /customize to /customize/overview and consolidates duplicate docs paths to make /customize the single canonical section. Addresses Linear issue CON-4476 and resolves dead-link feedback from PR #8469.
Bug Fixes
Refactors
Written for commit 32fe915. Summary will update automatically on new commits.