Skip to content

break: migrate from Eta v2 to v4 - #12404

Merged
slorber merged 2 commits into
facebook:mainfrom
slorber:codex/migrer-de-eta-v2-a-eta-v4
Sep 3, 2026
Merged

break: migrate from Eta v2 to v4#12404
slorber merged 2 commits into
facebook:mainfrom
slorber:codex/migrer-de-eta-v2-a-eta-v4

Conversation

@slorber

@slorber slorber commented Sep 3, 2026

Copy link
Copy Markdown
Collaborator

Breaking

For users using the siteConfig.ssrTemplate option (probably not many), the Eta syntax might have changed a bit. Eta releases do not explicitly document the changes.

Motivation

Maintenance upgrade

Changelogs of major version bumps:

The Eta API is used internally, so API breaking changes are not important for users.

It's not clear what the breaking changes are in terms of the syntax template, but most Docusaurus users probably do not provide a custom SSR template and apparently the impact is quite limited:

The syntax also remains almost exactly the same

I'll still consider this a breaking change, but we don't really have more details to mention apart from reading the Eta docs.

See the syntax doc: https://eta.js.org/docs/4.x.x/syntax/template-syntax

Test Plan

CI

Test links

Deploy preview: https://deploy-preview-12404--docusaurus-2.netlify.app/

@slorber
slorber requested a review from Josh-Cena as a code owner September 3, 2026 14:45
@slorber slorber added the pr: breaking change Existing sites may not build successfully in the new version. Description contains more details. label Sep 3, 2026
@meta-cla meta-cla Bot added the CLA Signed Signed Facebook CLA label Sep 3, 2026
@netlify

netlify Bot commented Sep 3, 2026

Copy link
Copy Markdown

[V2]

Name Link
🔨 Latest commit dc39076
🔍 Latest deploy log https://app.netlify.com/projects/docusaurus-2/deploys/6a9987f462dfa00007ddd5b2
😎 Deploy Preview https://deploy-preview-12404--docusaurus-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@slorber slorber added the Argos Add this label to run UI visual regression tests. See argos.yml GH action. label Sep 3, 2026
@argos-ci

argos-ci Bot commented Sep 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build Status Details Updated (UTC)
screenshots (Inspect) 👍 Approved by Sébastien Lorber 1 changed Sep 3, 2026, 3:16 PM
text-snapshots (Inspect) ✅ No changes detected - Sep 3, 2026, 3:17 PM

@slorber
slorber merged commit 20fe35d into facebook:main Sep 3, 2026
43 checks passed
@slorber slorber mentioned this pull request Sep 3, 2026
31 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Argos Add this label to run UI visual regression tests. See argos.yml GH action. CLA Signed Signed Facebook CLA pr: breaking change Existing sites may not build successfully in the new version. Description contains more details.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant