前几天在bbs上，看到有人说需求文档太难写了，他在帖子里面这样写：有时候我认为，写需求文档本身比作系统分析更难。
真的是这样么？
实际上在我看来，很多时候我们觉得写不出来分析文档，根本的原因是我们没有对这个问题作出很好的分析。其实系统分析产生的文档只有那么几个，有些项目中可能是用系统功能说明书或者是系统分析报告，各种原型或者一些别的文档，比如说遗留系统分析，业务流程改进说明，等等吧，甚至有的以概要设计的名义出现，有的用用例文档甚至各种uml图的形式出现，而在XP开发中可能是User Storey，这在写法上都不是问题，因为都有既有的模式可以参照。觉得写文档难有两个可能的原因：一是根本不知道写什么好，那么这说明系统分析没有做到位， 二是组织文字的功力不够，肚里有一大堆的话不知道怎么说，那么这个其实是缺乏写这方面文档的经验，可以通过看既有的分析文档或者自己慢慢的练习进行改进的，因为模仿别人写东西总是比较容易吧，写多了自然自己就有心得了?
但是在系统分析中，我们必须搞清楚的是：任何文档都是为了说清楚你要描述的事情，如果你连你要描述的事情都不清楚，那你形式上修饰的越好可能起的负作用越大，因为你可能让你的受众关注于你形式上的华丽而不是内容的空洞。所以首要的问题是你要搞清楚你要分析的事情，针对各种问题你要能够给出一个合理的解决之道，对各种细节你要做到能够清楚明白，套用温伯格《探索需求》中的一个词，就是你要不断的减低含混性。当然这也和软件过程有关。
系统分析过程中面对的人大都是没有多少计算机知识的人，他们描述出来的东西和他们想象的东西很可能是不一样的，而他们所想的东西也不一定是最好的解决方法。作为一个系统分析师，首先要能够从这些一点技术含量都没有的描述中看到他们真实的需求，从表象中看到用户真正需要的东西，要帮他们进行改进，这才是系统分析师真正应该做的工作。当然文档也很重要，不过我觉得文档本身写起来还是比较容易的，毕竟都有大量的模版模式可以借用，但是探索需求本身却是一项艰难的工作。 这个世界上有大量的软件在交付后都不能让客户满意，很大一部分原是因为系统分析没有做到位。