导航

当我读《活文档》时我在想什么

Posted on 2022-06-06 21:57  Caiger  阅读(57)  评论(0编辑  收藏  举报

写在前面

  • 这本书长这样

  •  这本书不是讲“不写文档”,而是讲把传统文档上记的知识分散到具体地方。
  • 每一章按“先解释再举例”来组织文字,但我觉得解释部分写的比较重复,看起来容易困。
  • 我把它归到“不用敲代码也能读下去”类别。

一些感想

  • 因为“能不能不写文档”的宣传,我开始读这本书。边读边想到实际工作中遇到的与“文档”有关的问题,比如某编辑器缺少说明书,导致策划不知道怎么用;又比如某个功能没有设计文档,导致新程序员接手时对它的设计目的连蒙带猜;再比如程序员A已经研究过一遍的功能,交给程序员B时,B又要重头研究一遍。我觉得在查找定位上花的时间都很可惜,因为这一阶段常常学不到什么东西,大多是白白浪费时间。
  • 这本书讨论的“活文档”,首先应用在自己身上就是“如何做笔记”,再进一步就是“如何正确共享项目知识”,读了还是有用的。