Skip to content

docs: reframe JJ as implementation detail in README#42

Merged
timeleft-- merged 2 commits intomainfrom
feature-jj-reframe-readme
Apr 3, 2026
Merged

docs: reframe JJ as implementation detail in README#42
timeleft-- merged 2 commits intomainfrom
feature-jj-reframe-readme

Conversation

@timeleft--
Copy link
Copy Markdown
Member

Summary

  • Lead with "Git-native, curated memory" instead of "VCS-backed" in the opening
  • Remove JJ from opening paragraphs and "Why" section — describe outcomes, not tools
  • Rewrite Prerequisites to lead with colocate reassurance ("Your repo remains a standard Git repo")
  • Add note to Manual Push section clarifying most users never need those commands

Consensus Review

  • GPT 5.4 Pro (for): 8/10 messaging clarity, 8/10 adoption friction reduction — endorses direction
  • Gemini 3.1 Pro (neutral): 10/10 — "masterful progressive disclosure", technically accurate framing
  • Grok 4.1 Pro unavailable on OpenRouter

Manual follow-up needed

  • Update GitHub About description (web UI): remove "Backed by Jujutsu VCS", add "Draft isolation, promotion gates, supersession chains"
  • Add git-native GitHub topic (web UI)

Test plan

  • All 618 tests pass (uv run pytest -v)
  • Visual review of README rendering on GitHub

🤖 Generated with Claude Code

timeleft-- and others added 2 commits April 3, 2026 08:33
…tive outcomes

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…ath, name JJ in comments

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@timeleft-- timeleft-- merged commit 55ed6e8 into main Apr 3, 2026
7 checks passed
@timeleft-- timeleft-- deleted the feature-jj-reframe-readme branch April 3, 2026 12:47
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.

1 participant