Skip to content

docs: Add zdiff3 concept article#96

Draft
Ziinc wants to merge 2 commits into
mainfrom
cursor/zdiff3-article-6440
Draft

docs: Add zdiff3 concept article#96
Ziinc wants to merge 2 commits into
mainfrom
cursor/zdiff3-article-6440

Conversation

@Ziinc

@Ziinc Ziinc commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a learn concept article on Git's zdiff3 (Zealous Diff3) conflict style under web/learn/concepts/git/, and links it from the Git concepts index.
The article covers:

  • How merge, diff3, and zdiff3 present the same conflict differently
  • Enabling zdiff3 globally, per-repo, or for one conflicted file
  • A side-by-side example of the three marker layouts
  • When to prefer each style, and team/ops notes for shared config and marker-aware tooling
    Written in the treq docs voice per /writing (style guide + readability checker: Flesch ~61, no hard bans or AI tells).

Test plan

  • Confirm the page renders at /learn/concepts/git/zdiff3
  • Confirm the Git concepts index card links to the new page
  • Spot-check DefinitionCard terms and the conflict marker examples
  • python3 .claude/skills/writing/scripts/readability.py web/learn/concepts/git/zdiff3.mdx --strict
Open in Web Open in Cursor 

cursoragent and others added 2 commits July 22, 2026 06:09
Document merge, diff3, and zdiff3 conflict presentation so readers can
enable zealous Diff3 and interpret three-way conflict markers.

Co-authored-by: Ziinc <Ziinc@users.noreply.github.com>
Shorten the conflict comparison setup line for clearer prose.

Co-authored-by: Ziinc <Ziinc@users.noreply.github.com>
@github-actions github-actions Bot changed the title Add zdiff3 concept article docs: Add zdiff3 concept article Jul 22, 2026
@github-actions

Copy link
Copy Markdown
Contributor

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.

2 participants