Skip to content

docs: align READMEs with git-native positioning - #194

Merged
z2z23n0 merged 1 commit into
mainfrom
feature/zh-readme-repositioning
Jun 18, 2026
Merged

docs: align READMEs with git-native positioning#194
z2z23n0 merged 1 commit into
mainfrom
feature/zh-readme-repositioning

Conversation

@z2z23n0

@z2z23n0 z2z23n0 commented Jun 18, 2026

Copy link
Copy Markdown
Collaborator

Mainline Intent

Intent: int_541ceb7d
Status: proposed
Title: 同步中英文 README 到 Git 原生意图记录定位

What changed

重写 README.md 和 README.zh.md 的主体定位:中文采用用户修改后的版本作为 source of truth,补回原中文截图到“为什么需要它”上方;英文 README 按同一结构和叙事重写为自然、专业的英文表达,并保留原有两张英文截图在 Why It Matters 上方。

Why

官网已经转向“AI 时代的 Git / Git 原生意图记录”叙事,产品 README 也需要从旧的 intent review 中心叙事调整为:Mainline 把 Agent 的工程判断随代码一起保存到 Git,让 Agent 像使用 Git 一样自然读写历史决策,并继承 Git 的多人协作能力。

Decisions

  • README 主叙事: 以“AI 时代的 Git / Git for the AI era”作为开场定位,强调 Agent 决策和代码历史一起存进 Git。 (这比旧版“先 review intent 再 review code”更贴近新版官网核心卖点,也能更直接解释 Mainline 为什么不需要独立对话日志或共享记忆服务。)
  • 英文 README 处理方式: 不逐字翻译中文,而是按相同产品结构写成 native/professional 英文。 (用户明确要求英文版不要翻译腔;英文文案保留同样信息层次,但使用英语 README 更自然的表达。)
  • 图片位置: 保留中文原 Hub 截图和英文原两张截图,并放到“为什么需要它”/“Why It Matters”上方。 (用户明确要求原先图片不要丢,且图片位置仍在问题说明段落之前。)

Subsystems: docs, README, product-positioning

@z2z23n0
z2z23n0 marked this pull request as ready for review June 18, 2026 19:29
@z2z23n0
z2z23n0 merged commit 868ad5f into main Jun 18, 2026
8 checks passed
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