技术成果文档化是否限制了个人的发展

　　电脑商网8月22日讯：在IT企业中，公司往往希望技术成果能够文档化，以利于公司长期发展。但是，中国产业中很少有这样认真而确实的工作态度和做法。

　　从个体角度出发，这样的观点很难说是一个错误的行为，体现的是经济学中所说的人的“自利”天性。对于这种天性是否正确，有必要从个人利益是否受损、是否能有所增长的角度来进行评判。这样的过程对组织的帮助又在哪里?

　　技术成果文档化对个人提高的必要性

　　技术成果的评审过程是对文档化过程进一步稽核和纠正的过程，在这个过程中，究竟是谁获得了更多的提高和利益，这一点回答是非常重要的，应该从以下4个角度看待技术成果文档化和评审过程：

　　◆ 技术成果文档过程是一个自我提高和逻辑显式化过程。

　　在日常过程中，我们常常发现，对知识点的看、说、写、教4个步骤是一个不断提高的过程，对于很多东西，看明白不一定能说清楚(实际是没有彻底看明白)、能说出来不一定写得有逻辑(实际是没有想明白)、写出来不一定能说服别人(是因为没有将其深层次内容挖掘出来)，因此技术成果文档化过程是自我提高的过程，这一点非常重要。实际我看到的许多好的软件工程师也是文档写作的高手，阅读其文档内容如行云流水，逻辑非常清爽和干净。

　　◆ 技术成功文档评审过程是一个评判和再思考的过程。

　　一个高效的讨论过程是一个有预案的过程，作为有靶子“攻击”的会议，其评审的效率必然是比较高的。另外在会议中，看到许多人在陈述问题或在争论观点时突然变得豁然开朗。当然这样的会议过程中需要在技术方面专业的人士参加，不必渴求全部明白的全才，深知一方的专家去对于其中一部分提出建议就足够了。

　　◆ 经过评审获得好的技术文档也是作业者去争取更好工作机会的基础。

　　在保住工作的同时，其实人人从骨子中寄希望于从事更高更有挑战性的任务，而实际能力提高也是人们获得更多机会的不二法门。我常跟人说，让一个人看守2000行代码是没有问题的，但是如果其目标只是看管5×2000行代码，则可能再也无其他工作的可能了。抱残守缺的意义何在呢?

　　◆ 经过评审获得好的技术文档更是培养新人的过程。

　　新人的提高只有通过好的文档和相应的代码学习，是熟悉业务和专业知识以及工作模式的最好途径。新人的提高有利于团队能力提高，一个公司的产品质量和技术层次的高低是和这个团队的技术高低相关，很难想象一个低水平团队中会有一个卓然不群的高手?实际上，传帮教带是一个人在组织中威望提高的重要手段。而如果从另外角度而言，真正的技术高手是通过业界评判而定，并非是一个小小圈子的“能人”。

　　可以看到，在一个技术线有深度的开发过程中，技术成果文档化和评审化的过程是一个形成积极向上和协助精神团队文化的过程。以上4个要素点中前两个是对于起步者的劝诫，而后两点则是对中高级人才的忠告。

　　技术成果文档化对企业发展的必要性

　　技术成果经认真评审后形成的知识成果是组织技能的体现，也是进一步知识共享和知识再利用的过程。

　　◆ 知识共享是企业效率提高的唯一途径。

　　软件工程中“不要再造轮子”，意味着软件代码重用的高手才是真正的高手，我们需要去制作满足需求的成果，而并不是一定的重新开始辛劳的工作。对于组织知识更是如此，我们面临的竞争是其他组织的效率和成本的竞争，因此共享团队的知识是尤为重要的。

　　◆ 通过对知识传播和利用，加快知识在组织中传播的速度。

　　企业所面临的压力传导到企业中各个层次，其间他们在资源和绩效方面的竞争是不可避免的。因此必须对知识再利用者予以鼓励，对于知识提供者我们也需要有显式的激励。能够很好地使用别人的成果的同志需要鼓励，同时提供这方面知识的单位和个人也需要奖励。这样才能构成“知识收集-整理-共享-使用-再造-提高”的过程。在软件工程中，我们强调评审更多是看是否正确，而去说配置更多是看是否留有轨迹，其实这一切还是以知识再利用为目标，否则即使再详细的配置库存在的意义也是几近于零。这里所说的不是个人的思想观点，而是组织所希望评审和文档化以及配置的出发点必须有相当的高度。