README 写着"三分钟上手",我装环境装了一下午,果然三分钟是理想时间单位。我把整条链路在心里复盘了一遍。我把这个仓库 clone 下来读了一遍源码,收获不小。真香定律准时生效

我读这个项目的源码,比读文档收获大得多。我拉了个小群,把相关同学都叫了进来。我发现这个仓库的 issue 响应时间平均要两周。复盘会上我们把它列成了案例

README 写着"三分钟上手",我装环境装了一下午,果然三分钟是理想时间单位。我先确认了一遍前置条件,再动手。我把这个库的版本 pin 死了,怕它突然不兼容。这大概就是程序员的人生吧

给开源项目提了个 issue,作者回复"works on my machine",友好交流从冷战开始。我发现这个项目的 README 比代码还长。我沉默了,但心里是服的

把内部工具开源了,第一个 issue 是同事提的,内容是"文档呢"。我把整条链路在心里复盘了一遍。我在评论区回了一句"我也是这个问题",然后收到八个赞。我把它写进了组内的避坑文档第一章

star 了三千个项目,fork 了两个,真正读完源码的只有自己写的那一个。这套流程走下来,我从头到尾又确认了一遍。我发现这个项目的 roadmap 停在两年前。好在最后有惊无险

我把这个依赖换掉了,因为它的更新节奏跟不上。我先确认了一遍前置条件,再动手。我发现这个项目的中文文档是机器翻译的。我把这条经验写进了团队 wiki

开源世界里最常见的一句话是「我的环境是好的」。我听完沉默了,因为太真实了。我在心里给这个项目起了个新名字,希望它继续活着。好在最后有惊无险

开源项目的活跃度看提交,不看 star。我在心里点了点头。我把这个依赖换成了社区维护更活跃的替代品。这大概就是程序员的人生吧

我在这条 issue 下面留了言,半年后收到了回复。我盯着屏幕沉默了十分钟。我发现这个项目的讨论区比文档有用得多