Linus亲述：不写文档，如何统领千万开源开发者

　　我原以为Linus那句"文档是给失败者看的"是吹牛，结果去年十二月看他在LinuxConf上亲口说，差点没把咖啡喷到显示器上——那显示器还有点色偏，看啥都泛黄，搞得我误以为他演讲背景板是屎黄色。

　　当时我们组正卡在组件库的文档规范上，前端小哥第N次把"按钮状态"写成"按纽状太"，切图文件夹里的命名乱得像我家猫挠过的毛线团——什么"btn_hover_new_v2_final_真的最后版.png"，我数位笔的笔尖刚换过，戳屏幕都带颤音，结果他扭头说："要不咱们学Linus，不写文档？"

　　可拉倒吧。

　　Linus能不写文档，是因为Linux内核的代码提交门槛高得像珠峰北坡。去年光是Git的提交规范就筛掉80%的野生开发者——你试试用"git commit -m '修复了那个bug'"提交？分分钟被Linus的邮件轰炸喷成筛子。我们呢？上周刚收了个PR，注释写的是"应该能行"，切图连阴影方向都跟设计稿反着，这种水平不写文档？第二天前端就得集体辞职。

　　但你说"优胜劣汰"这事儿，我倒真信。Linus的邮件列表里，每天都有开发者因为代码风格被喷到退群——不是喷你逻辑错，是喷你缩进用空格不用Tab，喷你变量名没按驼峰式，喷你注释里的英文语法比我的四级作文还烂。这种近乎偏执的规范，反而成了最硬的文档——你不用看README，被喷两次就知道该怎么写。

文章配图，仅供参考

　　Linus的"无文档"能成立，本质是靠代码本身的自解释性。你看Linux内核的代码，变量名起得跟论文标题似的，函数注释写得像小说段落，连错误提示都带梗。我们呢？上周看后端写的API文档，返回状态码写"200：成功"，404写"找不到"，500写"服务器炸了"——这他妈也叫文档？切图命名都比这规范。

　　我原以为"优胜劣汰"是靠技术，结果发现是靠喷人。Linus喷人的邮件被开发者当圣经传，我们组前端喷人只会说"你这间距不对"——没气势啊！上周我让他学Linus，结果他邮件里写"你他妈的间距能对齐吗？"，被产品经理投诉到HR那，说我们组"职场暴力"。色板里那个说不清的灰（#8a8a8a还是#8b8b8b？）都能吵半天，哪还有空学喷人？

　　但话说回来，Linus的"无文档"也不是完全没规则。他有个隐藏的"文档"：所有核心开发者必须熟读《Unix编程艺术》，必须能背出"KISS原则"，必须知道"过早优化是万恶之源"。这些规则没写在纸上，但刻在每个开发者的DNA里——你违反一次，被喷；违反两次，被踢；违反三次，连邮件列表都进不了。我们呢？上周刚招了个新人，问他"栅格系统是什么"，他说"是不是用来抓老鼠的？"——这种水平，不写文档？明天首屏就得崩。

　　显示器色偏这事儿越来越严重了，昨天看设计稿里的蓝色，实际渲染出来像青苔。前端小哥说"要不按色值调"，我说"调个屁，Linus连色板都不看，咱们也别纠结"——结果产品经理看到首屏，当场拍桌子："这蓝色怎么这么丑？跟设计稿完全不一样！"得，又得改。切图命名里的"final_真的最后版"已经出到v8了，文档？文档还在"待完善"状态躺着呢。

　　我后来想明白了，Linus的"无文档"是给超高手玩的。就像武侠小说里的大侠，不用剑谱也能打遍天下——但咱们这种小门派，没剑谱连三流高手都打不过。上周看GitHub上有个开源项目，文档写得比小说还厚，结果贡献者是Linux的10倍——你说这打谁脸？

　　所以现在我们的策略是：核心代码不写文档（反正能喷走80%的菜鸟），但组件库、API这些必须写，而且要写得像说明书——毕竟前端小哥的记忆力，连昨天吃的啥都记不住，更别说记变量名规则了。色板里的灰最终定了#8a8a8a，因为产品经理说"这个看着舒服"——管他呢，能过审就行。

　　至于Linus的"优胜劣汰"？我们组现在也在用——不过筛的不是开发者，是需求。上周产品经理提了个"一键生成PPT"的功能，我们直接回"做不了，技术难度太高"，他居然没反驳——后来才知道，他偷偷问过前端小哥，小哥说"得写2000行代码，还得改现有架构"，产品经理当场怂了。你看，有时候"不写文档"的精髓，是学会说"做不了"。

　　窗台上的绿萝彻底死了，我打算买盆仙人掌——至少不用浇水，像Linus的代码一样，自生自灭。数位笔的笔尖又该换了，切图命名里的"final"已经出到v12，文档？文档还在"待完善"状态躺着呢——不过至少我们学会了喷人，虽然没Linus那么狠，但至少能让新人知道，栅格系统不是用来抓老鼠的。

（编辑：天瑞地安资讯网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!