现在的位置: 首页 > 综合 > 正文

编写和评审设计文档时的点

2013年09月02日 ⁄ 综合 ⁄ 共 568字 ⁄ 字号 评论关闭

这整整一个月我们都在写文当评审文档,干的挺没劲的,但是里边确实有道道啊,其实说白了,还是工作不用心,学习不认真所导致。

经过这段时间的编写,和两次的评审也得出了些结论:

写作技巧:
1 UML图中有明显的错误。但是我画图的时候体会不到错误。这个需要学习
2 措辞,不能太口语化了
3 使用的专业名字,如果是英文的那么就必须要一致,这里的一致说的是,书写上要一直,意思要需要一致,就算不一致也需要写明理由。appid/Appid/APPID/appIDAppId
4 反复检查用在你的文档中的列举,是否每一个字段都说的清楚,而且你这么做都能解释,让人接受。
5 有些可以列举全的项就不要使用“等”这个词了。
6 编写文档的时候可以适当的将需要重点讲的地方加粗或者有所提示,以便于自己回想起来这块想说明什么。
辩论技巧:
你写在文档中功能只要跟现实不是矛盾,能说的过去,那么就可以作为说辞
你的文章在某一点上存在一些语义模糊,说不清楚时,也可以提出来大家一起讨论,这也是解决尴尬的一个方案。
在辩论前你必须是的你的文档是在很严谨的情况下写的,这样才能理直气壮辩论。
最主要的一点就是,随机应变!
可以讲每个需要将的地方重点讲下,其他不重要的地方可以很粗略的越过,这样就不至于前篇一律这样没有重点的讲下去,而听得人也可以知道你想表达什么意思。

---暂时先写这么写着吧!后面再修改!

抱歉!评论已关闭.