天下程序员苦文档久已 | 《活文档》第一波短评 - Go语言中文社区

天下程序员苦文档久已 | 《活文档》第一波短评


小伙伴们都知道,这是我们最近刚刚上架的一本书。这本书切中了不少程序员的痛点,因此,一上架就成为大家抢购的图书,最近一周一直稳居新书销量榜榜单。

除了预览版大佬们推心置腹的推荐,我们已经收获了第一批读者的感悟。

先来看一下,张逸、朱少民、张银奎和刘冉四位老师提前审阅这本书的推荐语。

以下是第一批读者的感悟,其中有技术管理者,也有普通程序员。

王旭,Kata Containers 创始人

快速看了一章,我觉得思考和原则都蛮好的,即使方法不能完全应用,但也有很多值得借鉴的。看到“为了对话”这里有些感触,因为之前曾经读到过“好的文章本质上是一种对话”。嗯,这里的共同意思是说,找到对象,有目标性的东西更有意义。

Phodal,ThoughtWorks 工程师

这本书介绍的活文档的观念,和我最近几年做的事情非常相似:如使用定制化的 Markdown 作为知识存档工具,使用定制化的 DSL 取代图表,拓展 Gherkin 以承载更多的知识……

简单来说,传统的文档难以进行版本化管理,所以我们需要更灵活的方式让文档活起来。

当然了,我并不建议你们用语雀这样的工具,知识应该以 Git 进行管理,代码化,才好演进和重构。

叶糖糖,Java 研发工程师

这本书让我觉得很惊艳,不是因为书中有华丽的词藻,而是它戳中了我们软件研发团队的痛处。目前我就职于一家互联网公司,所在的事业部门主要负责智慧医疗以及远程问诊相关的业务。每天在办公室里都会听到测试团队的主管和前端团队的主管因为业务问题而争吵,上周更是因为在工作群里的对话,引起了老板的注意,让部门总监马不停蹄直接从上海分公司赶回来处理“因为业务需求问题引发的血案”。

事情的经过其实很简单,产品的 prd 写得不清楚,研发团队认为需求不明确,本期需求迭代不实现此功能。测试团队认为原型图上有这个设计,那研发同学就得实现,不管合不合理。很好奇的是,为什么大家不一起去找产品解释 prd?而是在办公室里内讧,让上海团队的产品、研发、测试团队看笑话。

还有一个故事,说的是我们的支付服务系统会经常报错 null,据说这是上海团队有个外籍华人负责的项目(不缺钱的那种程序员)。前几天老大因为接口返回 null 的问题,跟其理论了一番,最后老大以骂骂咧咧的姿态爆炸。TM一个十几年的程序员,接口返回 null 值,一个错误提示也没有?

其实一切的根源都源于,大家的认识不一致,也没有统一的文档,来验收大家的工作,有的只是随心所至,那怎么会不出问题呢?

非常推荐各位已经担任管理岗的研发童鞋阅读此书,为了团队的和谐。哈哈。

杨帆,鹅厂高级开发工程师

会写文档-> 写好文档->写活文档 [加油][加油] BDD实施参考。

限 时 折 扣

京东传送门

更多了解这本书的信息,请戳:

让程序员头疼的文档问题怎么破?(可以看到本书图文并茂的风格)

张逸老师的《活文档》阅读长评 (可以了解很多活场景)

一  问

你是否开始读这本书了,欢迎留言区或者豆瓣本书页面留下你的评论,跟其他小伙伴分享你的感悟。

版权声明:本文来源CSDN,感谢博主原创文章,遵循 CC 4.0 by-sa 版权协议,转载请附上原文出处链接和本声明。
原文链接:https://blog.csdn.net/turingbooks/article/details/115222320
站方申明:本站部分内容来自社区用户分享,若涉及侵权,请联系站方删除。
  • 发表于 2021-06-12 11:52:00
  • 阅读 ( 1775 )
  • 分类:职场

0 条评论

请先 登录 后评论

官方社群

GO教程

猜你喜欢