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

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

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

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

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

王旭，Kata Containers 创始人

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

Phodal，ThoughtWorks 工程师

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

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

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

叶糖糖，Java 研发工程师

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

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

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

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

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

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

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

限时折扣

京东传送门

更多了解这本书的信息，请戳：

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

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

一问

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

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

程序员到底需要什么样的需求文档?
PMCAFF(www.pmcaff.com):互联网产品社区,是百度,腾讯,阿里等产品经理的学习交流平台.定期出品深度产品观察,互联产品研究首选. 外包大师(www.waibaodashi.com): ...
java开发文档怎么写_程序员该不该写技术文档，怎么写文档，易懂又能提升自己...
最近公司项目的调用量突然涨了一大波,很多系统都纷纷扛不住了,于是需要对系统进行优化,系统优化的第一步,便是梳理业务! 在这个过程中,经常出现了这样一些情况,发现数据库的某些字段,没有注释,也没有一定的 ...
一款程序员不可不拥有的正规编程语言文档库查询软件——zeal
今天在张老师的课上,老师向我们介绍了一款非常强大的软件--zeal 你还在用百度进行反复的资料查询和搜索嘛? 你还在多个博文之间的交错信息进行反复的斟酌与纠结嘛? 你还在为找不到正规的资料而发愁吗? ...
Java程序员进阶架构师必备学习文档：SSM+微服务+分布式+Nginx+MySQL
SSM企业级战 SSM框架是以Spring为核心,整合Spring MVC和Mybatis的轻量级框架技术的组合.利用SSM整合框架可以开发出分层.易扩展.易维护的企业级应用系统,能够极大地满足企业需 ...
程序员 6 个接私活的网站，有技术就有钱！
作者:Java面试攻略原文链接:http://dwz.date/bKMa 前言本篇文章会向大家推荐国内外几个接外包比较靠谱的平台,主旨是贵精不贵多.因此,像「猪xx」这种会让程序员自贬身价,扰乱市 ...
工作快满5年，聊聊这5年作为程序员中的那些事（文末加了结局揭晓和3年后近况的彩蛋！！）
引言毕业将近5年了,一般来说,工作5年是一个槛,今天就聊聊俺这5年所作为程序员,所经历的一些事,分享给大家,希望有一定借鉴作用吧. 毕业的彷徨俺老家是江西的,在大学混了3年多,基本上都是玩过来的, ...
程序员接私活平台_程序员去哪儿接私活？我系统总结了15个国内平台，绝对靠谱...
和大家分享一下如何判断项目是否靠谱,有哪些接项目的渠道,以及其他接私活的经验. 首先判断项目是否靠谱,直接说给我开发一个什么软件,不说具体需求,没有需求文档的都不靠谱,这样的项目不要接. 需求文档越详 ...
程序员去哪接私活？分享10个兼职平台，人已赚麻
你们当程序员不会都拿着几千.万把块钱的死工资吧,今天为大家分享一些可以接私单的平台,我反正已经赚麻了. 如果你的工作相对没那么费时间,可以空闲的时候去接点私活.或者是还没有找工作之前,可以通过一些平台 ...
Android程序员如何高薪接私活？十年老炮告诉你，看这一篇就够了
随着互联网的发展各大公司接二连三的裁员前一秒工作安排,后一秒优化通知搞副业接私活+提升主业技能该是安卓人该有的觉悟了都应该要有自己的plan b 尤其是程序员这种远程岗位一部电脑+技术就 ...

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

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

最新文章

热门文章