持续交付2.0

这么好的东西在国内行业大环境下,真的有用么?

今天看到一篇公众号文章,题目是《程序员必备:技术文档写作指南》。

这让我想起了2022年腾讯PCG 曾启动过一个针对所有技术人员的系列培训。

其中部分内容继承自腾讯大师兄在十多年前提出的《海量之道》系列培训,并针对当前软件工程与技术发展的现状与趋势,增加了一些新的内容。

这一系列课程花费了很多心思打磨,很多课程还经过了腾讯VP 曾宇的试听

其中很重要的一个课程,就是《技术文档写作》。

技术文档在《谷歌软件工程》一书中,也作为一个单独的章节,进行了详细的阐述。

然而,这么好的内容在国内大环境下,真的有用么?

程序员会说:“

难道我不会写文档么?

可我连写好代码的时间都没有,哪有时间写文档?”

所以,想要人做好某件他力所能及的事情,需要先解决好资源问题。

  • 你让程序员自测,那他有没有时间呢?

  • 你让程序员写好文档,那么,他有没有时间呢?

  • 你让程序员写好文档,那么,谁来Review呢?

  • 他有时间做高质量的Review吗?

  • 程序员有时间根据修改意见来修订文档么?

想要别人做好某件他力所能及的事情,就需要先解决好资源问题。

如果,你认为你给了足够多的资源(比如时间),

那么你确认你找到了合适的人了么?哈哈哈

说不定,是你应该放低要求呢?!哈哈哈