如何写一份敏捷的文档 | IDCF
DevOps
共 5668字,需浏览 12分钟
· 2021-07-14
来源:小船哥说敏捷 作者:adoudou
一、什么是“文档”
在分析敏捷开发中的文档之前,我们要先搞清楚什么是“文档”。
维基百科给出的解释是:
具有三个基本属性,即:知识性、记录性、物质性,它具有存贮知识、传递和交流信息的功能。
从这个定义我们可以知道:“文档”可以理解为一切可以存贮知识、促进沟通、传递信息的有形或无形的资料。
弄清楚“文档”的概念后,我们就可以继续分析敏捷开发中的文档了。
二、敏捷文档≠不写文档
很多团队在看到敏捷宣言的这句话以后:
工作的软件高于详细的文档。
都会产生一个问题:既然软件比文档重要,那敏捷开发是不是可以不写文档了?
在这里我们就假设在软件开发过程中是可以不写任何文档的,那我们日常的工作场景可能会是这样的:
迭代计划会的时候,没有任何书面的Backlog,PO把需求跟大家口述一遍,然后就直接开始开发; 迭代的过程中,没有设计图,没有接口文档,没有测试用例,没有bug记录……; 每日站会的时候没有看板,每个人都在口述自己昨天做了啥、今天要做啥,但是没人能清楚地知道总共要做多少功能,做了多少功能,还剩多少功能; 需求的改动全靠口头通知,请假或未出席会议的人全凭猜; PO对故事进行验收的时候,因为没有可视化的文档,导致开发团队做的东西根本不是他想要的,不停地返工; 评审会上,因为bug太多,新功能演示频频翻车,客户不欢而散; 回顾会上,SM发现没有任何客观数据可供回顾的,于是大家随便聊点不疼不痒的话题,散会; 项目勉强上线,没有用户手册,没有运维文档,无人会使用,没人能维护; 项目卒。
三、敏捷文档=创造价值的文档
Scrum 是一个轻量的框架,它通过提供针对复杂问题的自适应解决方案来帮助人们、团队和组织创造价值。 ——《Scrum Guide 2020》
四、怎样写出一份创造价值的敏捷文档
首先,你提供的文档要抓住客户的痛点,否则客户肯定会不断的要求你提供更多的文档。 其次,要客户非常具体地描述他对文档的需求,一定不能接受泛泛而谈的需求。比如客户说“我要一份产品文档”,这个“产品文档”就太泛了,但是如果说“我要一份产品的原型图”就具体多了。 第三,要确定文档的载体,也就是具体形式,比如是word,是Axure源文件,还是HTML? 最后,告诉客户你制作文档所需的工作量,你在文档上投入的任何时间,你本都可以用在新功能的开发上的,你必须让客户意识到这点,这样客户才不至于无止境的提文档的要求。
成本降低是因为你不会浪费时间去修改文档中已经变化的信息; 风险降低是因为你现有文档过时的可能性大大降低。
这时你很可能已经忘记了某些决定背后的原因,如果这些原因对你很重要的话,这个问题会很严重。 你可能没有合适的人再去写文档了,因为他们可能已经转向其他项目了。 你可能没有预算来做这项工作。 编写文档的意愿可能不复存在。
五、小结
评论
真高!比亚迪员工爆料比亚迪在越南的薪资水平:基本工资480万,全勤奖35万,交通补助20万,餐补110万,每周6天,每天10小时
上一篇:某大公司为逼迫员工离职,竟然把他的工位安排到厕所旁,没想到他直接开始记录领导的如厕时间,还发到公司大群...对此,你怎么看?--完--PS:欢迎在留言区留下你的观点,一起讨论提高。如果今天的文章让你有新的启发,欢迎转发分享给更多人。全文完,感谢你的耐心阅读。如果你还想看到我的文章,请一定给本
开发者全社区
0
太敢穿了!透视纱裙!性感火辣的身材
绝了呀今天的厂花:吴宣仪1995年1月26日,吴宣仪出生于海南省海口市,中国内地流行乐女歌手、影视演员。2016年2月,吴宣仪随宇宙少女发行首张迷你专辑正式出道。2018年4月,她参加《创造101》综艺选秀,获得第二名,成功加入火箭少女101组合。吴宣仪的颜值一直备受称赞,她的五官立体精致,皮肤白皙
逆锋起笔
0
某大公司为逼迫员工离职,竟然把他的工位安排到厕所旁,没想到他直接开始记录领导的如厕时间,还发到公司大群...
上一篇:字节的跳动职级与薪资(2024年)我们与公司间的合作,宛如两艘船只在茫茫大海上相互依靠,共同抵御风浪,携手驶向成功的彼岸。然而,当航向开始产生分歧,或是波涛汹涌的风浪改变了我们的初衷,我们或许应当冷静地选择和平分手,而非在风雨中硬撑。最近,一位网友的遭遇引起了广大职场人的关注和热议。这位网友
开发者全社区
0
金融研究 | 使用Python测量关键审计事项的「信息含量」
Tips: 公众号推送后内容只能更改一次,且只能改20字符。如果内容出问题,或者想更新内容, 只能重复推送。为了更好的阅读体验,建议阅读本文博客版, 链接地址https://textdata.cn/blog/2023-01-13-information-content-of-critical-aud
大邓和他的Python
0
我看阿里的年终奖总算发了!
到4月底了,这两天看朋友圈,发现阿里的年终奖终于发了,问了问老同学,也从网上检索了不少信息,基本搞清楚了阿里今年的年终奖情况。近来来阿里一些集团对绩效等级做了较大的调整,以前的旧绩效系统中,绩效分为3.25、3.5、3.75、4和5五个等级,其中4和5是较高绩效等级,较少见。而且之前3.5绩效内部划
公子龙
0
CVPR 2024|大视觉模型的开山之作!无需任何语言数据即可打造大视觉模型
↑ 点击蓝字 关注极市平台作者丨科技猛兽编辑丨极市平台极市导读 本文提出一种序列建模 (sequential modeling) 的方法,不使用任何语言数据,训练大视觉模型。>>加入极市CV技术交流群,走在计算机视觉的最前沿本文目录1 序列建模打造大视觉模型(来自 U
极市平台
1
金融研究(更新) | 使用Python构建关键审计事项的「信息含量」
Tips: 公众号推送后内容只能更改一次,且只能改20字符。如果内容出问题,或者想更新内容, 只能重复推送。为了更好的阅读体验,建议阅读本文博客版, 链接地址https://textdata.cn/blog/2023-01-13-information-content-of-critical-aud
大邓和他的Python
0
字节的跳动职级与薪资(2024年)
上一篇:阿里公布年终奖,P7, 3.5+,22W年终奖,还有35W长期现金激励,真香字节跳动自2012年3月成立以来,已经迅速成长为一个全球性的科技公司。其产品和服务已经遍布全球150多个国家与地区,并且支持超过75种不同的语言。在字节跳动的官方网站上,列出了一系列引人注目的产品和服务,包括但不限于
开发者全社区
0