这么好的东西在国内行业大环境下,真的有用么?
今天看到一篇公众号文章,题目是《程序员必备:技术文档写作指南》。
这让我想起了2022年腾讯PCG 曾启动过一个针对所有技术人员的系列培训。
其中部分内容继承自腾讯大师兄在十多年前提出的《海量之道》系列培训,并针对当前软件工程与技术发展的现状与趋势,增加了一些新的内容。
这一系列课程花费了很多心思打磨,很多课程还经过了腾讯VP 曾宇的试听
其中很重要的一个课程,就是《技术文档写作》。
技术文档在《谷歌软件工程》一书中,也作为一个单独的章节,进行了详细的阐述。
然而,这么好的内容在国内大环境下,真的有用么?
程序员会说:“
难道我不会写文档么?
可我连写好代码的时间都没有,哪有时间写文档?”
所以,想要人做好某件他力所能及的事情,需要先解决好资源问题。
你让程序员自测,那他有没有时间呢?
你让程序员写好文档,那么,他有没有时间呢?
你让程序员写好文档,那么,谁来Review呢?
他有时间做高质量的Review吗?
程序员有时间根据修改意见来修订文档么?
想要别人做好某件他力所能及的事情,就需要先解决好资源问题。
如果,你认为你给了足够多的资源(比如时间),
那么你确认你找到了合适的人了么?哈哈哈
说不定,是你应该放低要求呢?!哈哈哈