Skip to content
Merged
Show file tree
Hide file tree
Changes from 17 commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions REDIRECTS_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ A comprehensive guide for managing redirects in Mintlify documentation (migrated
## Overview

Redirects are essential when restructuring documentation (IA refactor) to ensure:

- Old links don't break
- Search engine rankings are preserved
- User bookmarks continue to work
Expand Down Expand Up @@ -67,7 +68,7 @@ Add a new object to the array:

```bash
# Run the dev server
mintlify dev
mint dev

# Test the redirect
# Navigate to http://localhost:3000/old-page-path
Expand Down Expand Up @@ -150,11 +151,13 @@ mintlify dev
### No Wildcard support

**Nextra** (supported):

```
/docs/* /tutorials/:splat 301
```

**Mintlify** (NOT supported):

```json
{
"source": "/docs/*",
Expand All @@ -167,10 +170,9 @@ mintlify dev
```json
{
"redirects": [
{"source": "/docs/page1", "destination": "/tutorials/page1"},
{"source": "/docs/page2", "destination": "/tutorials/page2"},
{"source": "/docs/page3", "destination": "/tutorials/page3"}
{ "source": "/docs/page1", "destination": "/tutorials/page1" },
{ "source": "/docs/page2", "destination": "/tutorials/page2" },
{ "source": "/docs/page3", "destination": "/tutorials/page3" }
]
}
```

Loading