敏捷开发需要编写文档吗?
来源:互联网 发布:淘宝网返利如何领取 编辑:程序博客网 时间:2024/04/27 14:44
在产品研发过程中经常需要编写很多文档,例如:需求文档、设计文档、API文档、验收文档等等。团队成员要花费很多精力去维护众多的文档,甚至有“兄弟,我替你写代码,你替我写文档”的无奈。
敏捷开发宣言
* 个体和互动 胜于 流程和工具
* 可以工作的软件 胜于 详尽的文档
* 客户合作 胜于 合同谈判
* 响应变化 胜于 遵循计划
敏捷宣言的第二条“可工作的软件胜于详尽的文档”,很多人理解为敏捷开发不重视文档,甚至以此为借口逃避写文档。同样,在对待”敏捷开发是否需要架构设计”的问题上也有类似极端的看法。
敏捷宣言在写什么样的文档以及如何写方面并没有给出任何刚性的指导原则,那么在敏捷管理的项目中我们该如何编写文档呢?
首先,我们需要理解敏捷宣言背后的思想。
敏捷4条宣言都是在强调“价值”、“快速交付价值”、“为客户提供价值”的理念。换句话说,研发团队要把精力放在能够为客户带来价值的地方,避免在不产生价值或者ROI(投入回报率)低的任务上浪费时间。
其次,我们要理解文档的作用是什么?文档是用来准确传递信息,帮助理解事物,沉淀知识。
基于以上理解,在遇到是否要写文档的疑问时,可以通过回答两个问题来判断
- 是否有比写文档更高效传递信息的方式?
- 简陋的文档是否满足需要?
从文档的读者来划分
读者是项目组外人员
这类文档往往是需要编写的而且不能“简写”的。例如:用户手册、验收文档、API文档等。读者是项目组内人员
这类文档能省则省,能简则简。如果能够在每天站会上沟通的,就可以不写。建议高层的系统架构图、内部API文档可以简写。
如果项目Leader通过类似EasyPM这样管理工具能够查询到的信息,可以在周报中简写甚至省略。
对于可以“简写”的文档,可以考虑使用Markdown格式。
Markdown是一种简单易用的标记语言,用户可以使用这些标记符号以最小的输入代价生成极富表现力的文档。
EasyPM 的文档编辑器使用Markdown语法,并且实时保存/预览、支持代码高亮、文档评论以及全文搜索。在版本管理上,支持手动和自动进行版本管理。文档评论也支持@功能,可以高效地对文档进行评审。
- 敏捷开发需要编写文档吗?
- 敏捷开发需要哪些文档?
- 软件开发需要编写的那些文档
- 软件开发需要编写的那些文档
- 在软件开发中需要编写的规范性文档
- 敏捷开发也需要对症下药
- 软件开发文档编写
- 我们需要什么样的敏捷开发?
- 如何编写敏捷开发中的user story
- 如何编写敏捷开发中的user story
- 敏捷开发智慧敏捷系列之二:写不写文档?
- 敏捷开发智慧敏捷系列之二:写不写文档? .
- 【敏捷开发】从"需求文档"出发聊敏捷
- 在敏捷开发中如何维护文档
- 敏捷开发实践(2)-要不要文档?
- 敏捷开发实践(2)-要不要文档? .
- 【敏捷开发每日一贴】写不写文档?
- 敏捷开发中文档的取舍
- HDU 2094 产生冠军
- 日历生成装置和日历生成方法
- UI第十一天
- 随机数产生转换-根据(1,5)随机数生成器,生成(1,7)之内的随机数
- Linux C高级编程——文件操作之库函数
- 敏捷开发需要编写文档吗?
- java操作阿里云的对象存储OSS
- IT忍者神龟之 Linux必学的60个命令
- 又见01背包(数据较大,重量和价值互换)
- Fragment如何避免onCreateView重复调用
- Java方法签名与JNI,反射
- [VS2010].NET4.0环境下使用.NET2.0程序集,出现“混合模式程序集异常”
- ADT - Bundle 中的Eclipse 无法启动, 卡在loading workbench 界面无响应
- 友元 友元函数及类