Skip to content

Conversation

@icyJoseph
Copy link
Collaborator

@icyJoseph icyJoseph commented Oct 25, 2025

Also closes: #85344

@ijjk ijjk added created-by: Next.js DevEx team PRs by the DX team. Documentation Related to Next.js' official documentation. labels Oct 25, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Oct 25, 2025

All broken links are now fixed, thank you!

>
> - In Proxy, you can also read cookies using `req.cookies.get('session').value`.
> - Proxy uses the [Edge Runtime](/docs/app/api-reference/edge), check if your Auth library and session management library are compatible.
> - Proxy uses the Node.js runtime, check if your Auth library and session management library are compatible. You may need to use [Middleware](https://github.com/vercel/next.js/blob/v15.5.6/docs/01-app/03-api-reference/03-file-conventions/middleware.mdx) if your Auth library only supports [Edge Runtime](/docs/app/api-reference/edge)
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
> - Proxy uses the Node.js runtime, check if your Auth library and session management library are compatible. You may need to use [Middleware](https://github.com/vercel/next.js/blob/v15.5.6/docs/01-app/03-api-reference/03-file-conventions/middleware.mdx) if your Auth library only supports [Edge Runtime](/docs/app/api-reference/edge)
> - Proxy uses the Node.js runtime, check if your Auth library and session management library are compatible. You may need to use [Proxy](/docs/app/api-reference/file-conventions/proxy) if your Auth library only supports [Edge Runtime](/docs/app/api-reference/edge)

Line 1124 contains a broken GitHub link to deprecated middleware documentation. The link should reference the internal documentation for Proxy instead: /docs/app/api-reference/file-conventions/proxy.

View Details

Analysis

Broken documentation link in authentication guide

What fails: Line 1124 in docs/01-app/02-guides/authentication.mdx contains an incorrect documentation link pointing to a GitHub URL for deprecated middleware documentation.

How to reproduce:

  • Open docs/01-app/02-guides/authentication.mdx
  • Navigate to line 1124
  • The link text reads [Middleware](https://github.com/vercel/next.js/blob/v15.5.6/docs/01-app/03-api-reference/03-file-conventions/middleware.mdx)

What happened vs expected behavior:

  • The link pointed to a GitHub blob URL targeting a non-existent middleware.mdx file (deprecated in favor of proxy)
  • Expected: Link should point to the internal documentation path /docs/app/api-reference/file-conventions/proxy and display [Proxy] as the link text
  • The pattern matches existing correct usage at line 1026 in the same file

Fix applied: Changed line 1124 from:

[Middleware](https://github.com/vercel/next.js/blob/v15.5.6/docs/01-app/03-api-reference/03-file-conventions/middleware.mdx)

to:

[Proxy](/docs/app/api-reference/file-conventions/proxy)

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

For the time being, I reckon we need to link to some documentation about Middleware for those who are using Edge runtime.

@icyJoseph icyJoseph merged commit ec0d166 into canary Oct 27, 2025
75 checks passed
@icyJoseph icyJoseph deleted the docs/fix-proxy-matcher-overflow branch October 27, 2025 16:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

created-by: Next.js DevEx team PRs by the DX team. Documentation Related to Next.js' official documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: proxy runtime is inconsistent (edge vs nodejs)

4 participants