开发团队的知识管理

知识管理的概念其实很大。我了解的也很有限,今天仅从我个人角度随便写一写。

知识沉底的动机

知识管理得先有知识再谈管理。好多团队在第一步就卡壳了。

团队管理者常常抱怨程序员不爱写文档,硬逼着才积累了一些文档。写的也是应付差事,没有什么实际价值。

有些程序员还拿代码即文档作为不写文档的挡箭牌。

程序员不爱写文档众所周知。但程序员却又是最喜欢看文档的群体。是不是很矛盾?心里骂着,这 TM 谁写的程序,一点文档也没有。自己却成为了自己不想成为的样子。唯一理由可能就是时间不够(懒)吧?

代码即文档这个概念没问题,但这是用来规范代码书写的,并不是不写文档的理由。

知识并不是代码能完全表达的。比如解决方案。API 代码写的再好读,也仅限于这个API。当几个 API 再加几个定时任务构成一个方案,仅凭代码很难理解。

让团队有写文档的热情,首先需要让团队感受到文档带来的帮助。当有人问到你某个问题,你说这里有一份文档,想要的答案都在里面了。这个感觉是不是很爽?

每个团队都在努力建设自己的乌托邦。每个成员从团队索取,也为团队贡献自己的力量。团队不应该是开发story的巨型机器。

知识沉淀方便别人,同时也方便自己。想激励团队写文档,首先团队要将文档真正用起来,体会到有文档的好处!

知识怎么管理

  1. 知识管理工具需要便于书写、检索。
    知识管理工具非常重要,开发觉得好用才会有更多的动力去写文章沉淀知识。工具中的检索功能最为重要,否则知识中心终将沦落为形象工程。

  2. 知识唯一存放位置
    只有一个存放位置,从这个存放位置可以找到任何想要的内容。多于一个位置都会对使用者产生困惑,也不利于传播。

  3. 以文档形式组织知识
    文档对检索更为友好。幻灯片或者视频,无法对内容进行检索。
    文档可以精准定位到你关心的段落。
    文档可以持续维护。确保知识的实效性。并且文档易于版本对比。
    录屏固然方便,但是问题多多,建议录屏之外再提供一份文字版。

  4. 质量
    太多同类文档会影响知识的使用。一搜一大把类似的文档,我应该看哪个?

重要文档要有质量要求。需要按照统一的模版编写。就像写代码一样,文档也要看起来像一个人写的。

©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容