发版说明我列了三大页,后来压成一句话

我当时以为，把这次改了什么列清楚，就算尽责了。

那几年我写发版说明，有个固定写法。从第一条往下排，这个单据加了个字段，那个单据加了个功能。再往下是顺序调了、说法换了。写完拉下来，三大页。

我一条一条对着需求核。核完，发出去。

我一直觉得这样没问题。改动都在这儿了，一条没漏，谁想看自己看。

有个同事跟我说过一句话，我到现在还记得。他的意思，大概是这么回事。

我第一反应是想解释。这个版本就是改了这些，我能写的也只有这些。

话到嘴边，我停住了。

因为他说的是对的。我自己翻那三页，翻到第二页就开始跳。看完也说不出这个版本到底干了件什么事。

一、每一条我都清楚，可我没想过它意味着什么

那三页里写了什么，我全清楚。一条条都能对上需求，都能说出是谁提的。

但有个问题我一直没问过自己。这一条改动，对用系统的那个人来说，意味着什么。

我写下的是"这个单据现在能干什么了"。他用的时候，遇到的是"我今天这一步还麻不麻烦"。

同一件事，在我这里是一句话，在他那里是一天里的几分钟。

我以前只写前一种。

二、后来我把第一句换掉了

我不是说以后注意点。是真改了写法。

以前第一句就是"本次升级包括以下内容"，后面跟着一到十。后来我把这句换掉。第一句改成，这次升级解决的是什么事。

差别有多大，举一条最小的就清楚。

有个地方原来要点两下，现在一下就好。以前我这么写：某个地方的操作步骤，由两步改成一步。

后来我改成：这个版本少了一次重复操作。用得最勤的人，每天大约少点几十下。

第二句里，多了一个具体的人。

一开始很别扭。有的版本我卡在第一句上，卡挺久。要把"我们改了什么"翻成"这是什么问题"，得先说清这个问题本来在给谁添麻烦。

卡住的时候我才发现，前面那些我写得那么顺的版本，可能本来就没解决什么事。

三、清单是安全的，价值不是

后来我想明白，我为什么会一直写清单。

列清楚改了什么，是一件可以核对的活。对着需求过一遍，一条不落，就算交差。清单长到十几条也不费劲，反正都是照着需求抄。

说清楚"所以呢"，得下判断。判断可能错。你以为对他有用的事，他可能根本不关心。

一个不会错，一个会错。人本能地选前一个。

发版说明越写越长，也是这个道理。系统越做越大，改动只会越来越多。清单顺着这个长势走，价值提炼是逆着它走。

我想，这么写的大概不止我一个。清单体省事，还挑不出错。要按需求一条条抄，谁也不能说你没尽责。

四、想不出来的时候，我就认了

现在再写发版说明，我会先花点时间想那个"所以呢"。

有时候想不出来。想不出来我就认了，这个版本确实没什么好说的，老老实实写清楚，不硬拔。

想出来的时候，那一版发出去，我心里才是踏实的。

把改动列全，只能证明我干过活。说清楚它改变了谁，才算我真的交付了。

你们那边，发版说明给的是结论，还是清单？

这里的每篇，都是我在项目里真实遇到的事和做产品的思考。感兴趣的可以关注一下。