我们一起来读书吧 关注:129贴子:1,931
  • 0回复贴,共1

《谷歌软件工程》第三章 知识共享

只看楼主收藏回复

文档
文档是书面知识,其主要目的是帮助读者学习一些东西。并非所有的书面知识都一定是文档,尽管它可以用作书面记录。例如,有可能在一个邮件列表线索中找到一个问题的答案,但线索上的原始问题的主要目标是寻求答案,其次才是为其他人记录讨论情况。
更新文档
如果你发现文件中的错误或遗漏,就把它改正过来
创建文档
确保有一个反馈的机制。如果没有简单直接的方法让读者指出文档过时或不准确,他们很可能懒得告诉别人,而下一个新来的人也会遇到同样的问题。如果人们觉得有人会真正注意到并考虑他们的建议,他们就会更愿意做出改变
推广文档
指点团队成员去看文档
编写文档也有助于你的团队和组织的扩展。首先,文档中的信息成为规范化的参考:团队成员可以参考共享的文档,甚至自己更新它。其次,规范化可能扩散到团队之外。也许文档中的某些部分对团队的配置来说并不独特,对其他想要解决类似问题的团队来说变得有用。


IP属地:北京1楼2024-06-04 19:10回复