跳到正文
联系

遗作文档定律

编程与 BUG

文档如果存在的话,会极其精确地描述程序的上一个版本。

— 佚名, 计算机民间传说
VIDEO.EXE16:9

技术文档是一种独立的文学体裁,介于历史小说和遗嘱之间。它详尽地描述一个已经不复存在的世界:被挪走的按钮、改了名的菜单、在一场四分钟的会议上被砍掉的功能。

原因很简单。代码在跑,文档在走。等终于有人写好第二版的手册时,程序员们已经在为第四版吵架了。

我有个客户把他那套管理软件的手册放在玻璃柜里,像供奉圣物。他时不时打开,用庄严的语气大声朗读里面的步骤。没有一条和屏幕对得上。但他说,这能帮他回忆起按钮还在左边的那个世界。说实话,我理解他。