Google8号员工和现在的工程高级副总裁UrsHölzle明确说：写作是工程师重要的超能。  工程师经常低估写作的重要性。投资这项技能，以扩大您向其他人传达信息的能力，成为更有影响力的工程师。大多数.

避免无意义的注释评论，不添加任何价值。如果通过阅读代码可以清楚地看到某些内容，则评论只会增加噪音。考虑是否可以改进代码，以便不再需要注释。通过改进命名，重构（例如，提取函数）或引入解释变量，通常可以解.

近来公司需要写软件开发文档，文档主要是用来指导开发人员作实际开发用的，之前自己是coder，现在写这种文档不知道如何下手，从哪几个几角度，需要画什么图，都不是很清楚，希望各位指教！.

1、类图肯定要生成，但是跨package就麻烦，如何解决。2、先模拟client 运行一个例子，调试进入source，好像会太琐碎，没有大局观。3、文档肯定要看的，但是好像一般没有设计文档。希望大家讨.