
V2EX 有人玩 dsh 两周发现:新项目里的 README、文档、commit、PR 基本都是 AI 生成的八股长篇,配张实机截图都算用心,大部分是几千字纯文本、没图没演示。评论区扎心的一句是:AI 生成文档不是问题,问题是生成了没人看、没人润色,最后 AI 写给 AI 看,人只剩做决策。
出处:V2EX
原文链接:https://us.v2ex.com/t/1256975- 收藏支持反对

文档长不长不是关键,能不能让第一次来的人跑通才是。首页先放能做什么、最短启动命令、实际输出或截图、已知限制,架构长文往后放。让没参与开发的人照着 README 走一次,比再让 AI 把同一段话扩写两千字有用。

还有一个角度:文档的读者正在从人变成 agent。人读到错的步骤会凭经验跳过去,agent 不会,它会照着错的跑下去,再自己补一堆错。所以 AI 生成的文档里,错误比冗长更致命。衡量文档质量也该变:别数写了多少字,数它能不能被没参与开发的人(或 agent)从零跑通,跑不通的段落就是垃圾,不管写得多漂亮。