这两天写文档的一点感受

到公司两天了，一直都在写一个文档。我平时并不怎么注意写文档，偶尔写写也只是事后总结，正儿八经的项目文档这还是破天荒头一遭。

说来挺惭愧，就这么两三页的文档，我写了两天，改了两次，这已经是第三次写，至于通不通的过目前还不知道。两次被卡给我的教训不少，值得好好检讨一下。

第一天到公司，正赶上公司开始数据库建模，因为项目组只我一个人用过PowerDesigner，所以经理让我写一份关于《如何建立CDM》的文档。其实我也只是偶尔用PD做做OOM，CDM从主管嘴里说出来之前我是闻所未闻，没办法了，谁让咱大话说到前面了，硬着头皮也要顶。

还好建立CDM并不是很难，看了看帮助文档，做了一个example，倒也有了些眉目，于是根据自已对CDM的理解，写了个流程文档。就和昨天我发那个用PowerDesigner进行概念数据建模（初体验）差不多。

结果文档到主管那，卡了！主管说，域和继承项目中用不到，删！我心想就算用不到放在文档里大家当学习和参考资料也不错嘛，当然嘴上没敢说。唉，删就删吧。于是重做了example，这次又加了图示，同时加上了一些概念的解释，并通过CDM生成PDM后的对照来说明之间的关系。就这样删了一部分却加入了更多。

第二次将文档check in到VSS上，不一会主管又把我叫了去，问我role name做什么用？（因为我的图示上此项有填写内容）我说是角色名，可有可无，主管大笔一挥说，“图表中不能有中文，这个功能你把它从图表中拿掉，以免误导其它人。还有PDM图等与建立CDM无关的也删掉”。这时我才恍然大悟，原来主管让我写的是一个建立CDM的规范化文档，既然是规范性的东东，表述自然得准确、明了。唉，又失败了.......

反省两次的失败教训，检讨了一下，总结为以下几点：

1.缺少CDM建模经验，以至于在写文档时没有重点，没有根据项目需求做出取舍。

2.没有理解主管的意图就勿忙下手。犯了需求分析不充分的错误。

第三次写文档，我删了大部分解释性的东西，对于建立CDM的流程更加细化和准确，对于重点、易错的部分做出提示。我想这次总不会再被卡了吧......