English
Follows #4307 Q4; supports #3404.
Problem
README.md and README.zh-CN.md run 291 and 287 lines and still serve as landing page, install guide and architecture summary. Since #4660, maka.apache.org is the landing page and the downloads path. The README and the repository description still open with "local-first AI agent workspace" while the homepage uses the positioning settled in #4307.
Outcome
Both READMEs and the .asf.yaml description open with the #4307 sentence, and the README keeps only what a reader inside the repository needs. Everything that describes the product to a newcomer links to the site instead.
Work
Out of scope: homepage copy, which lives in website/src/copy/ and changes through #3404's fact-check cadence.
简体中文
承接 #4307 Q4;支撑 #3404。
问题
README.md 与 README.zh-CN.md 分别 291、287 行,仍同时充当 landing page、安装指南和架构摘要。自 #4660 起,maka.apache.org 已是 landing page 和下载入口。README 与仓库描述仍以 "local-first AI agent workspace" 开头,而首页用的是 #4307 定下的定位句。
目标
两份 README 与 .asf.yaml 的 description 以 #4307 定位句开头,README 只保留仓库内读者需要的内容;面向新人介绍产品的部分一律链接官网。
工作项
不在范围内:首页文案,位于 website/src/copy/,按 #3404 的事实核查节奏更新。
Drafted with help from Claude Code. I reviewed the final text and take responsibility for posting it.
English
Follows #4307 Q4; supports #3404.
Problem
README.mdandREADME.zh-CN.mdrun 291 and 287 lines and still serve as landing page, install guide and architecture summary. Since #4660,maka.apache.orgis the landing page and the downloads path. The README and the repository description still open with "local-first AI agent workspace" while the homepage uses the positioning settled in #4307.Outcome
Both READMEs and the
.asf.yamldescription open with the #4307 sentence, and the README keeps only what a reader inside the repository needs. Everything that describes the product to a newcomer links to the site instead.Work
.asf.yamldescriptionwith: "Apache Maka (Incubating) is a high-performance agent workspace that keeps a complete record of everything it did."https://maka.apache.org/en/downloads/; drop the recommendation to build from source as the only path, and keep the Desktop Nightly and npm snapshot labels consistent with the downloads page.Out of scope: homepage copy, which lives in
website/src/copy/and changes through #3404's fact-check cadence.简体中文
承接 #4307 Q4;支撑 #3404。
问题
README.md与README.zh-CN.md分别 291、287 行,仍同时充当 landing page、安装指南和架构摘要。自 #4660 起,maka.apache.org已是 landing page 和下载入口。README 与仓库描述仍以 "local-first AI agent workspace" 开头,而首页用的是 #4307 定下的定位句。目标
两份 README 与
.asf.yaml的 description 以 #4307 定位句开头,README 只保留仓库内读者需要的内容;面向新人介绍产品的部分一律链接官网。工作项
.asf.yaml的description改为:"Apache Maka (Incubating) is a high-performance agent workspace that keeps a complete record of everything it did."https://maka.apache.org/en/downloads/;不再把源码构建作为唯一推荐路径,Desktop Nightly 与 npm snapshot 的标注与下载页保持一致。不在范围内:首页文案,位于
website/src/copy/,按 #3404 的事实核查节奏更新。Drafted with help from Claude Code. I reviewed the final text and take responsibility for posting it.