Skip to content

Conversation

@devin-ai-integration
Copy link
Contributor

Update redirects to reflect new permanent default

Summary

This PR updates the fern-api/docs repository to align with the redirect behavior change in fern-platform#4141, which makes redirects permanent by default.

Changes made:

  • Removed all 187 instances of permanent: true from fern/docs.yml since it's now the default behavior
  • Updated redirect documentation in fern/snippets/redirects.mdx to reflect:
    • New default: permanent is now true (308 permanent/cached) instead of false (307 temporary/not cached)
    • Updated parameter descriptions per requirements:
      • source: "The incoming request path pattern"
      • destination: "The path you want to route to"
      • permanent: Explains true/false behavior with new default
    • Added example showing how to configure temporary redirects with permanent: false

Review & Testing Checklist for Human

  • Verify fern-platform#4141 behavior: Confirm that the platform change actually respects the permanent flag (PR description says it "ignores" the flag, but this PR documents it as configurable - need to verify intended behavior)
  • Check deployment timing: Ensure fern-platform#4141 is deployed before merging this PR, otherwise removing permanent: true could unintentionally change redirect behavior
  • Spot check removed entries: Review a sample of the 187 removed permanent: true lines in the diff to ensure only the intended lines were removed
  • Verify documentation clarity: Review the updated documentation in redirects.mdx to ensure it clearly explains the new default and status code implications

Test Plan

  1. After both PRs are deployed, test a few redirects to verify:
    • Redirects without permanent specified use 308 status code (permanent)
    • Redirects with permanent: false use 307 status code (temporary)
  2. Check that previously-permanent redirects still work correctly

Notes

- Remove all 'permanent: true' entries from docs.yml as it's now the default
- Update redirect documentation to specify default is now true (308 permanent)
- Update parameter descriptions to match user requirements:
  - source: incoming request path pattern
  - destination: path you want to route to
  - permanent: true by default, uses 308 (permanent/cached) or 307 (temporary/not cached)
- Add example of temporary redirect with permanent: false

Related to fern-api/fern-platform#4141

Co-Authored-By: [email protected] <[email protected]>
@devin-ai-integration
Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@github-actions
Copy link
Contributor

@devalog devalog closed this Oct 20, 2025
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