卖西瓜与写需求

    一次讲课中，给学员讲授关于项目范围定义编写的规范，告诉他们应该尽可能详细地说明每个业务功能内容，例如登录处理中：当用户请求登录时，系统应显示登录页面，用户在该页面填写用户名和密码并选择是否保留登录信息选项......
     学员一直都是以很简短的动词说明范围定义，如登录，下订单，购物车管理等等，而且对于这些详细描述很茫然。
     忽然间我想到了一个很古老的笑话：一老翁在路边卖西瓜，路上摆了很多西瓜，上面写个牌子：此处卖西瓜。一会儿后，一个人走过来说您这"此处"不要写了，这不明摆着是此处吗？于是把"此处"删了。又一会儿后，又一个人走过来说您这"卖"不要写了，这不明摆着是卖西瓜，难道还送西瓜？于是把"卖"字也删了。又一会儿后又走过来第三个人，他说您老这"西瓜"根本不要写，您这不卖西瓜难道还卖软件？于是把"西瓜"也删了。当然最后把牌子也拿掉了，上面什么字都没有还插什么牌子。
     想到这里我一直忍不住笑。好像其它人都要是你心中的蛔虫。我们什么时候简洁到如此程度了。我们程序员对于需求的描述不好大部分原因可能是语文功底不太好，当初念理科不就是因为语文不行吗？但我想思想中那点总以为别人应该清楚，应该明白是罪魁祸首。写需求文档时是不能因为以为别人知道而就忽略的！