项目开发感悟记录二：设计文档

上篇博客记录了关于需求分析的感悟，这里记录下我们项目前期产生的文档。文档的同一规范就不再继续说了。

我们的项目总共产生了四种文档：页面设计文档，用例设计文档，数据库表设计文档和类图设计文档。可以发现前期比较重要的流程图设计文档被省去了，这也是碍于时间不足。其实，这四类文档，我们也主要关注的是页面设计文档和数据标设计文档，其他的都没有做重要说明。先说说我观察到的问题吧！

1.文档规范很不明确；

2.如果是一个模板文档，那么这个模板文档应该经得起考验，应该让大家根据这个模板产生的文档的格式是统一的，不能在模板文档里面都存在不明确；

3.图的配套说明要先给出格式和条目，有一点十分重要，说明的内容应该做到简明厄要，不要来一些无关紧要的东西，这做的是开发文档，不是给用户看的文档，所以不应该假设文档的读者是个不懂行的人；

4.图的配套说明应该提醒图的设计者在设计审核通过前可以不加，因为一旦图审核不通过，那些文字就白费了，这也是浪费项目团队的时间，我觉得我们被这点浪费了很多，在页面设计文档上，我们总共做了200页，就是因为这个事情；

5.设计文档的谁先谁后应该告知团队成员，同时团队的boss应该自己清楚的知道那个最紧急，不能让团队把主力放到边缘上，这次我们组花了很多时间做类图，结果boss审核类图看到没看，如果把我们做类图的时间放到设计上，我们会设计的更加完善的；

关于文档，应该遵循一个主题：文档是设计的辅助，所以不要为做文档而做文档，尽量减少花在文档的非内容问题上：比如格式等等非内容问题；项目的负责人或者带头人应该提前制定这些规范。