Update from code changes: document editor version history

[mintlify]

Summary

Documents the editor version history and restore features introduced in mintlify/mint#9783 and mintlify/mint#9787.

Changes

• Adds workflow steps and explains the saved-version details shown in the editor.
• Clarifies page and branch scope, pagination, and version recording behavior.
• Documents restoring older versions, confirmation, permission requirements, blocked deploy branches, and unsaved-change replacement.
• Covers the feature in English, Spanish, French, and Chinese.
• Applies a documentation best-practices pass for translation parity, readability, links, metadata, and formatting.

---

Note

Medium Risk
Documentation-only changes to MDX guides. The documented restore action replaces current page content and can overwrite unsaved edits.

Overview
Documents the editor version history feature across English, Spanish, French, and Chinese editor/pages.mdx guides.

Adds a Version history section (after diff view in EN/ES/FR; after Markdown mode in ZH) covering how to open it via More options → Version history, what each saved entry shows (author, relative time, Latest), scope (current page and branch), Show more versions pagination, the docs.json exclusion, and the restore workflow for older versions.

Users with permission to edit a page can select Restore on an older version and confirm the action. Restore replaces the current page content, including unsaved changes. Restore is unavailable on blocked deploy branches and the Latest version. Users cannot compare versions from the drawer.

Frontmatter keywords now include version history; the Chinese page also gets a focused description covering version history alongside other page-editing topics.

Reviewed by Cursor Bugbot for commit 82db3dc. Bugbot is set up for automated code reviews on this repo. Configure here.

Update history

• Added the saved-version recording behavior introduced in mintlify/server#7138: Mint records entries when saved content differs from the latest version, skips unchanged duplicates, and supports empty saved pages.
• Added the editor history restore workflow introduced in mintlify/mint#9787: authorized editors can confirm restoring older versions, which replaces current content and unsaved changes.
• Added backend restore support introduced in mintlify/server#7200: restoring a version applies the selected snapshot to the current page within the current site, deployment, and branch.
• Added version comparison introduced in mintlify/mint#9869: selecting an older saved version opens a diff against the current page content, and selecting it again exits comparison.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Aug 5, 2026, 1:18 AM

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
tomee	🟢 Ready	View Preview	Aug 5, 2026, 1:18 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[mintlify]

Update from code changes updated this PR.

Updated Chinese editor page description for SEO compliance

Source PRs

• mintlify/server#7138 — feat: list editor Hocuspocus history

[mintlify]

Update from code changes updated this PR.

Added paragraph breaks to improve version history readability across four localized guides

Source PRs

• mintlify/mint#9787 — Add editor history restore action

[mintlify]

Update from code changes updated this PR.

Refined restore-scope wording across four localized editor pages

Source PRs

• mintlify/server#7200 — ENG-10518: restore an editor page version

[mintlify]

Update from code changes updated this PR.

Added no new documentation; completed a best-practices audit

Source PRs

• mintlify/mint#9869 — ENG-10609: compare and revert to a past editor version