Skip to content

Fixed 404s#411

Merged
sriramveeraghanta merged 1 commit intomasterfrom
fix-redirections
Mar 12, 2026
Merged

Fixed 404s#411
sriramveeraghanta merged 1 commit intomasterfrom
fix-redirections

Conversation

@danciaclara
Copy link
Collaborator

@danciaclara danciaclara commented Mar 12, 2026

Description

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • Feature (non-breaking change which adds functionality)
  • Improvement (change that would cause existing functionality to not work as expected)
  • Code refactoring
  • Performance improvements
  • Documentation update

Screenshots and Media (if applicable)

Test Scenarios

References

Summary by CodeRabbit

  • Chores
    • Reorganized documentation URL structure with multiple new redirects for quickstart, introduction, workspaces, projects, integrations, and API reference sections. Added dedicated overview pages to consolidate related content and improve navigation clarity.

@vercel
Copy link

vercel bot commented Mar 12, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Mar 12, 2026 10:34am

Request Review

@coderabbitai
Copy link

coderabbitai bot commented Mar 12, 2026

📝 Walkthrough

Walkthrough

This change updates vercel.json to add and modify URL redirects for the documentation site. New redirects are introduced to map legacy paths to updated documentation structure pages, including overview pages for workspaces, projects, integrations, and importers. An external redirect for webhooks documentation is also updated to point to a new path on an external developer portal.

Changes

Cohort / File(s) Summary
Redirect Configuration
vercel.json
Added ~30 new redirect mappings including /quickstart/introduction/quickstart, /core-concepts/workspaces/core-concepts/workspaces/overview, /core-concepts/projects/core-concepts/projects/overview, /integrations/integrations/about, and /importers/github/importers/overview. Updated external webhook redirect from /webhooks/:path* to point to https://developers.plane.so/dev-tools/intro-webhooks/:path* instead of the previous path.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 Hops through the docs with glee,
Old paths now leap to destinations new,
Overview pages bloom like clover,
Redirects guide each curious user through,
Navigation whiskers twitch with joy! 🌿

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Fixed 404s' directly describes the main purpose of the changeset—adding redirects to resolve 404 errors in the documentation site.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch fix-redirections

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 5

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@vercel.json`:
- Around line 13-20: The redirect from "/sign-up-sign-in" currently points to
"/introduction/signup-signin" which itself redirects to "/introduction/home",
creating a chain; update the redirect entry where source is "/sign-up-sign-in"
so its destination is the final target (e.g., "/") instead of
"/introduction/signup-signin" to flatten the chain (or remove the intermediate
"/introduction/signup-signin" redirect if you want a single mapping).
- Around line 46-52: Update the redirect entry that maps "source": "/projects"
(currently pointing to "destination": "/core-concepts/projects") to point
directly at the final target "destination": "/core-concepts/projects/overview"
to remove the redirect chain; locate the two redirect objects referencing
"/projects" and "/core-concepts/projects" and change the first object's
destination to "/core-concepts/projects/overview".
- Around line 38-44: The redirect entries create a 2-hop chain: an object with
"source": "/workspaces" currently points to "destination":
"/core-concepts/workspaces" and there's another object redirecting
"/core-concepts/workspaces" to "/core-concepts/workspaces/overview"; update the
first redirect so its "destination" is the final path
"/core-concepts/workspaces/overview" (or remove the intermediate redirect),
ensuring the "source" "/workspaces" maps directly to the final destination and
eliminating the redundant "/core-concepts/workspaces" redirect.
- Around line 102-108: The redirect chain defined for the route with "source":
"/importers/github-imp" and the subsequent rule for "source":
"/importers/github" sends users to "/importers/overview", which loses the
GitHub-specific page; update the redirect rules so that the "/importers/github"
entry either is removed (if redundant) or changed to point to
"/importers/github-imp" instead of "/importers/overview" to ensure requests for
"/importers/github" resolve to the GitHub Importer documentation.
- Around line 233-236: The redirect rule using source "/webhooks/:path*"
currently appends the ":path*" wildcard to the external destination, causing
404s for nested subpaths; update the rule so the destination for that redirect
is the fixed external URL "https://developers.plane.so/dev-tools/intro-webhooks"
(remove the ":path*" from the destination) while keeping the source unchanged to
ensure all /webhooks requests map to the base docs page.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: db9b6a3d-1412-4b3f-b0fa-21e1082a783e

📥 Commits

Reviewing files that changed from the base of the PR and between 72ab81e and f143fea.

📒 Files selected for processing (1)
  • vercel.json

Comment on lines 13 to +20
{
"source": "/sign-up-sign-in",
"destination": "/introduction/signup-signin"
},
{
"source": "/introduction/signup-signin",
"destination": "/introduction/home"
},
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Redirect chain detected.

Adding this redirect creates a 3-hop chain:
/sign-up-sign-in/introduction/signup-signin/introduction/home/

Multi-hop redirects degrade performance and SEO. Consider updating the existing redirect on lines 14-15 to point directly to the final destination.

🔧 Proposed fix to flatten the redirect chain
     {
       "source": "/sign-up-sign-in",
-      "destination": "/introduction/signup-signin"
+      "destination": "/"
     },
     {
       "source": "/introduction/signup-signin",
-      "destination": "/introduction/home"
+      "destination": "/"
     },
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@vercel.json` around lines 13 - 20, The redirect from "/sign-up-sign-in"
currently points to "/introduction/signup-signin" which itself redirects to
"/introduction/home", creating a chain; update the redirect entry where source
is "/sign-up-sign-in" so its destination is the final target (e.g., "/") instead
of "/introduction/signup-signin" to flatten the chain (or remove the
intermediate "/introduction/signup-signin" redirect if you want a single
mapping).

Comment on lines 38 to +44
"source": "/workspaces",
"destination": "/core-concepts/workspaces"
},
{
"source": "/core-concepts/workspaces",
"destination": "/core-concepts/workspaces/overview"
},
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Redirect chain detected.

Adding this redirect creates a 2-hop chain:
/workspaces/core-concepts/workspaces/core-concepts/workspaces/overview

Consider updating the existing redirect to point directly to the final destination.

🔧 Proposed fix to flatten the redirect chain
     {
       "source": "/workspaces",
-      "destination": "/core-concepts/workspaces"
+      "destination": "/core-concepts/workspaces/overview"
     },
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@vercel.json` around lines 38 - 44, The redirect entries create a 2-hop chain:
an object with "source": "/workspaces" currently points to "destination":
"/core-concepts/workspaces" and there's another object redirecting
"/core-concepts/workspaces" to "/core-concepts/workspaces/overview"; update the
first redirect so its "destination" is the final path
"/core-concepts/workspaces/overview" (or remove the intermediate redirect),
ensuring the "source" "/workspaces" maps directly to the final destination and
eliminating the redundant "/core-concepts/workspaces" redirect.

Comment on lines 46 to +52
"source": "/projects",
"destination": "/core-concepts/projects"
},
{
"source": "/core-concepts/projects",
"destination": "/core-concepts/projects/overview"
},
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Redirect chain detected.

Same pattern as workspaces: /projects/core-concepts/projects/core-concepts/projects/overview

Consider updating the existing redirect to point directly to the final destination.

🔧 Proposed fix to flatten the redirect chain
     {
       "source": "/projects",
-      "destination": "/core-concepts/projects"
+      "destination": "/core-concepts/projects/overview"
     },
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
"source": "/projects",
"destination": "/core-concepts/projects"
},
{
"source": "/core-concepts/projects",
"destination": "/core-concepts/projects/overview"
},
"source": "/projects",
"destination": "/core-concepts/projects/overview"
},
{
"source": "/core-concepts/projects",
"destination": "/core-concepts/projects/overview"
},
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@vercel.json` around lines 46 - 52, Update the redirect entry that maps
"source": "/projects" (currently pointing to "destination":
"/core-concepts/projects") to point directly at the final target "destination":
"/core-concepts/projects/overview" to remove the redirect chain; locate the two
redirect objects referencing "/projects" and "/core-concepts/projects" and
change the first object's destination to "/core-concepts/projects/overview".

Comment on lines 102 to +108
"source": "/importers/github-imp",
"destination": "/importers/github"
},
{
"source": "/importers/github",
"destination": "/importers/overview"
},
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check what importer documentation files exist
echo "=== Importer documentation files ==="
fd -e md . docs/importers 2>/dev/null || find docs/importers -name "*.md" 2>/dev/null

echo -e "\n=== Check for github-related importer files ==="
fd -i github -e md . docs 2>/dev/null || find docs -iname "*github*" -name "*.md" 2>/dev/null

Repository: makeplane/docs

Length of output: 491


Redirect chain loses GitHub-specific documentation.

The redirect chain /importers/github-imp/importers/github/importers/overview is problematic. Since github-imp.md exists with the actual GitHub Importer documentation, users following this chain will end up on the generic /importers/overview page instead of the GitHub-specific documentation.

Either remove the /importers/github redirect if it's not needed, or update it to point directly to /importers/github-imp to preserve access to the GitHub Importer documentation.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@vercel.json` around lines 102 - 108, The redirect chain defined for the route
with "source": "/importers/github-imp" and the subsequent rule for "source":
"/importers/github" sends users to "/importers/overview", which loses the
GitHub-specific page; update the redirect rules so that the "/importers/github"
entry either is removed (if redundant) or changed to point to
"/importers/github-imp" instead of "/importers/overview" to ensure requests for
"/importers/github" resolve to the GitHub Importer documentation.

Comment on lines 233 to 236
{
"source": "/webhooks/:path*",
"destination": "https://developers.plane.so/webhooks/:path*"
"destination": "https://developers.plane.so/dev-tools/intro-webhooks/:path*"
},
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Test if the external webhook URLs are accessible
echo "Testing external webhook redirect destinations..."

# Test base intro-webhooks page
curl -sI "https://developers.plane.so/dev-tools/intro-webhooks" | head -5

# Test a potential subpath
curl -sI "https://developers.plane.so/dev-tools/intro-webhooks/test" | head -5

Repository: makeplane/docs

Length of output: 364


Remove the :path* wildcard from the redirect destination.

The external URL https://developers.plane.so/dev-tools/intro-webhooks/ does not support nested subpaths. Testing shows the base path returns HTTP 200, but any subpath (e.g., /test) returns HTTP 404. This redirect rule will cause 404s for any request to /webhooks/:path*.

Change the destination to https://developers.plane.so/dev-tools/intro-webhooks without the wildcard appending:

{
  "source": "/webhooks/:path*",
  "destination": "https://developers.plane.so/dev-tools/intro-webhooks"
}
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@vercel.json` around lines 233 - 236, The redirect rule using source
"/webhooks/:path*" currently appends the ":path*" wildcard to the external
destination, causing 404s for nested subpaths; update the rule so the
destination for that redirect is the fixed external URL
"https://developers.plane.so/dev-tools/intro-webhooks" (remove the ":path*" from
the destination) while keeping the source unchanged to ensure all /webhooks
requests map to the base docs page.

@sriramveeraghanta sriramveeraghanta merged commit a07044e into master Mar 12, 2026
6 checks passed
@sriramveeraghanta sriramveeraghanta deleted the fix-redirections branch March 12, 2026 10:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants