游戏开发团队，你们系统有设计文档吗

Qn

从一个开发团队到另一个开发团队，接触新系统时，发现了很多问题，现在先提出一个。至于个个人水平差异，欢迎继续讨论。
此投票发布于GameRes，限定于游戏开发领域，开发者偏重于程序员。谢谢您的参与！

Qn

补充说明：代码中的注释，如果涉及到设计范畴，也可以列入此投票主题讨论的范畴

dopod

合格的架构师才是急需啊。没有这个人的基础，什么都是空谈。

dancercl

只有设计上有问题的系统才需要大量的文档和注释，所以个人认为你的分类不是很有道理
没有文档和注释就一定会让新成员根本无法理解吗？而有了完善的文档和设计图就能让新成员很容易理解吗？

设计完善的系统自身就是可解释的，文档只是附加性质的说明。一个基础扎实的程序人员，即使是第一次面对这样的系统，应该仅凭其代码本身也可以迅速溶入其中

总之差的系统才需要大量的文档和图表，因为它本身不能让人理解

fujingqiu

我们公司以前用的是CMM，所以就有很多文档。可是详细设计这一块CMM2好像管得不多，所以经常是程序改了，要求改了，设计文档没有同步修改。这种不能同步修改的文档其实就是垃圾，没任何涌出的样子货。
所以我认为文档应该非常简洁，简单明了、便于更新。如有和程序重复的地方，不写文档，以程序为主。

Qn

楼上几位说的好
引用一位IT业牛人的话:"没有注释的代码就是垃圾"
我们承认垃圾,制造垃圾,改造垃圾

♂樱♀

文档全而细致。但是不繁琐。
代码中，函数头有一个调用注释。由于伪代码已经在算法文档中给出，编码部分只有定点优化等特别难理解的地方有注释。

个人认为，注释太多影响代码阅读。
代表：linux

sanikoyes

我们公司没有什么软件工程概念，根本文档都没有多少；
刚来时感觉很费力。

Qn

我相信，中国的开发团队的优秀领导者们都明白软件工程，有过这个领域内的经验和教训，
能做得好的，是精英中的精英

Qn

♂樱♀: Re:游戏开发团队，你们系统有设计文档吗

代码中，函数头有一个调用注释。由于伪代码已经在算法文档中给出，编码部分只有定点优化等特别难理解的地方有注释。

比较赞成樱同学的做法，欣赏简洁易懂的编程风格，简单也是美；
一个团队里，如果自己写的代码只有自己看懂，无法被别人利用、维护，这些代码简直就是垃圾