Skip to content

docs: clarify proxy runtime history#93467

Merged
icyJoseph merged 2 commits into
vercel:canaryfrom
armando-andre:docs/clarify-proxy-runtime-history
May 5, 2026
Merged

docs: clarify proxy runtime history#93467
icyJoseph merged 2 commits into
vercel:canaryfrom
armando-andre:docs/clarify-proxy-runtime-history

Conversation

@armando-andre

Copy link
Copy Markdown
Contributor

What?

Clarifies the Proxy docs so the “Why Proxy” section no longer appears to contradict the Runtime section.

Why?

The Runtime section states that Proxy defaults to the Node.js runtime, but the “Why Proxy” section still said Middleware defaults to the Edge Runtime. Since Middleware was renamed to Proxy in v16, that wording could make readers think the current default runtime is Edge.

How?

Updates the “Why Proxy” paragraph to frame Edge Runtime wording as historical context rather than current default behavior.

Also updates the v16.0.0 version history entry to mention that Proxy defaults to the Node.js runtime.

Closes #93463

@github-actions github-actions Bot added the Documentation Related to Next.js' official documentation. label May 4, 2026
Comment thread docs/01-app/03-api-reference/03-file-conventions/proxy.mdx Outdated
@icyJoseph icyJoseph enabled auto-merge (squash) May 5, 2026 07:25
@icyJoseph icyJoseph self-requested a review May 5, 2026 07:26
@icyJoseph

Copy link
Copy Markdown
Member

To be able to merge this PR, you need to sign your commits.

To setup signing:

And then, rewrite your commit history:

git fetch origin
git rebase --exec 'git commit --amend --no-edit -S' -i origin/canary

and then push force with lease:

git push --force-with-lease

Sorry if some of these steps are a bit hard to follow, but we recently added the signature requirement.

armando-andre and others added 2 commits May 5, 2026 09:55
auto-merge was automatically disabled May 5, 2026 13:55

Head branch was pushed to by a user without write access

@armando-andre armando-andre force-pushed the docs/clarify-proxy-runtime-history branch from 5490fd2 to f8017ab Compare May 5, 2026 13:55
@armando-andre

Copy link
Copy Markdown
Contributor Author

Gotcha, don't worry. Let me know if it looks good now.

@icyJoseph icyJoseph enabled auto-merge (squash) May 5, 2026 14:36
@icyJoseph icyJoseph merged commit d38b4c2 into vercel:canary May 5, 2026
67 checks passed
@github-actions

github-actions Bot commented May 5, 2026

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: f8017ab

icyJoseph added a commit that referenced this pull request May 12, 2026
## Summary

Backports documentation fixes and improvements from canary to the
`next-16-2` branch.

### Included commits:
- eddbd54 docs: clarify that proxy/middleware matches static assets
by default (#92441)
- 43d1229 docs: clarify serverless runtime behavior for use cache
(#92232)
- 630d905 docs: add note on React canary version to View transitions
guide (#92315)
- 08f6f62 docs: note PPR default in cacheComponents reference
(#92378)
- 07182b5 docs: clarify cacheLife() cannot be called at module scope
(#92326)
- 7bb8e7d docs: add note on installing `server-only` in data security
guide (#92445)
- 6440b9e docs: update details about `unstable_retry()` behavior
(#91827)
- 246c5e1 docs: link updateTag from cacheTag reference (#92379)
- a99d7fd docs: native db drivers with sync queries (#92572)
- aef9105 docs: add Link transitionTypes version history (#92624)
- db1d2cc docs(cli): clarify that `--debug-build-paths` requires
route group folders in paths (#92618)
- 82f3f48 docs: fix broken bun.sh Nextjs documentation link (#92698)
- 5a15986 docs: add migration note for experimental cache flags to
cacheComponents (#92318)
- d1cf752 docs: draftMode alignment (#92794)
- ccc6d36 docs: amends to preserving-ui-state guide (#92270)
- 44e3208 docs: link Activity guide from Cache Components migration
guide (#92571)
- 2217cba docs: add guide for displaying dates without hydration
flash (#92786)
- d233d05 docs: remove broken error-handling overlay screenshot
(#93279)
- 356644b Update 05-server-and-client-components.mdx (#93374)
- ae88a95 docs: clarify rendering flow in Server/Client interleaving
example (#93381)
- b419190 docs: clarify proxy runtime history (#93467)
- e41fc92 docs: remove unreachable forms and mutations (#93509)
- 405a912 docs: broken link from usePathname compat call out (#93528)
- 58ea332 docs: escape literal triple-backticks in contribution guide
(#93584)
- d98ea7c docs: clarify cacheTag limit - it is per call (#93768)
- 7988818 docs: devIndicators with usage example (#93784)

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Joseph <icyJoseph@users.noreply.github.com>
Co-authored-by: MK <135491799+wwenrr@users.noreply.github.com>
Co-authored-by: wwenrr <wwenrr@users.noreply.github.com>
Co-authored-by: Aurora Scharff <66901228+aurorascharff@users.noreply.github.com>
Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
Co-authored-by: Abhishek Mardiya <97448460+abhishekmardiya@users.noreply.github.com>
Co-authored-by: Jiwon Choi <devjiwonchoi@gmail.com>
Co-authored-by: Hamed <55133282+hamedniroomand@users.noreply.github.com>
Co-authored-by: Jimmy Lai <laijimmy0@gmail.com>
Co-authored-by: christopherkindl <53372002+christopherkindl@users.noreply.github.com>
Co-authored-by: Zana Abdi <zana.abdi@hotmail.com>
Co-authored-by: Armando A. Calderón <armandoandrecalderon@gmail.com>
@github-actions github-actions Bot locked as resolved and limited conversation to collaborators May 20, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Documentation Related to Next.js' official documentation. locked

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Contradictory statements about Proxy/Middleware default runtime in proxy.md

2 participants