写文档

前天，给自己下达了一个小任务，用半天的时间完成一份文档。这是一份项目计划书，我是这么考虑的，因为已经有了一个版本，这次是根据用户的要求做出修改，要修改的地方已经很明确了，所以，并不需要花费太多的时间。然而，为了完成这个文档，我却花费了整整一天的时间。

看来，每次的经历都说明，写文档并不是想像的那么简单，虽然看起来只有那么几百个字，但要把一个计划凝聚成这几百个字，着实需要费些脑细胞呢。其实，在写计划书的时候，除了要凭借经验之外，更需要完成初步的系统分析工作。因为用户把自己的需求告诉你了，那么，如何实现用户的需求，必须根据自己在这方面的经验，先要搞清楚自己有没有这个能力，如果有能力，应该利用那些技术去达成，完成这些工作需要多长时间，甚至，更有可能的话可以设计出一个架构出来，并能够给用户做出更直观的演示。当这一切都成竹在胸的时候，文档也就出来了，否则，写出的文档全是空洞无物的东西，让用户不知你所云。可见，文档好不好写，关键还是要看你对项目的理解，用没用心。

说起来，这几天有两个项目搅在一块儿，而且都处在架构分析阶段。我不怕写程序、拼代码，虽然大部分时间也只做些复制、粘贴或者写些已经写过无数遍的代码，但毕竟还能遇到一些拦路虎，经常体会一下武松的感觉。我总感觉设计架构的时候让人头痛，可能是我的能力还不够吧。因为要考虑到很多方面的问题，大的如数据库的选择，小的如录入界面的规划，细节决定成败，尤其是对于软件项目，它的确不同于别的项目。一旦架构成了型，项目就算完成了一半。

我可能还得苦思冥想几天……