Skip to content

Document three-way merge for git-to-editor sync#5303

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/git-editor-sync-docs-1775865017
Open

Document three-way merge for git-to-editor sync#5303
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/git-editor-sync-docs-1775865017

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 10, 2026

Summary

The web editor now uses a three-way merge when syncing incoming Git changes, preserving local unsaved edits instead of overwriting them. Conflicts are highlighted in the editor for manual resolution. This also adds GitLab support for git-to-editor sync and skips sync for commits originating from the editor.

Changes

  • Added a "How Git changes sync to the editor" section to the Git essentials page explaining the three-way merge (base, local, remote) behavior.
  • Updated the "Resolve conflicts" section in the Publish page to describe how incoming changes are merged automatically and when conflicts are surfaced.

Note

Low Risk
Low risk documentation-only update that clarifies how the web editor incorporates incoming Git changes and surfaces conflicts.

Overview
Adds a new "How Git changes sync to the editor" section to editor/git-essentials.mdx, documenting that incoming repo updates are incorporated via a three-way merge (base/local/remote), auto-applying non-overlapping changes and highlighting conflicts; also notes that commits created in the editor don’t trigger a sync back.

Updates editor/publish.mdx conflict guidance to include incoming Git changes overlapping with unsaved edits, explains the editor’s automatic merge behavior, and links to the new Git essentials section for details.

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

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Apr 10, 2026

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 10, 2026, 11:54 PM

@mintlify-development
Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
userauth 🟡 Building Apr 10, 2026, 11:51 PM

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.

0 participants