应该在敏捷中创建哪些文档?

时间:2014-12-31 21:46:30

标签: architecture documentation agile software-design

我更多地询问ER图,用例图和其他UML图等技术文档。我知道敏捷是一个大词,有大量的材料,有很多不同的实现,还有很多关于它实际是什么的争论。

但是,从实际的角度来看,我需要知道的是,在开发过程之前和整个过程中创建了哪些文档?

3 个答案:

答案 0 :(得分:1)

我建议尽可能多地使用自动生成的文档。有很多工具可以根据您的代码对UML和ER图进行逆向工程。通过自动生成的Javadoc等来记录您的API。这消除了大部分文档工作量。

但是将文档工作包含在您的工作流程中非常重要,因为很少有东西比过时的文档更糟糕,这与生产代码相矛盾。因此,您可以添加"更新文档"到你的完成的定义

BDD是另一个有用的工具,它可以帮助您记录/定义软件的要求和功能,并在您实施测试以验证定义的方案后优化您的代码质量。

答案 1 :(得分:0)

来自Agile manifesto

“在综合文档上运行软件”

因此,与典型的瀑布流程(您需要创建文档(需求,设计,可跟踪性,验证/验证等))相比,Agile流程不需要任何文档。这个过程。

嗯,也许这是一个严重的过度简化。例如在Scrum中,你有一个Product Backlog,它是一系列用户故事,将通过一系列冲刺开发。可以说这是文档。

我认为规则的精神在于文档不是敏捷过程中的可交付成果。它不应该干扰客户协作。因此,无论如何,如果有助于双方沟通,请在会议期间与客户绘制ER图。在敏捷中,它没有真正的优点。

答案 2 :(得分:0)

我不完全赞同丹尼尔

Ofc我不能与宣言争论,但是在我看来,图表,文档绝对是可以接受的。

  1. 故事是一种描述。但对于程序员来说,它可能太少了。这个故事给出了什么时候会发生的信息,这应该转换成图表,文档
  2. 软件应该有详细记录。在sprint期间创建的图表和所有内容都将为未来的团队成员创建项目的最终文档,因为让我们认真对待,团队成员可以比我们想要的更频繁地进行更改
  3. 正确的问题是谁应该创造它。至于我,这是在开发团队方面。他们应该在从产品积压开发每个项目的同时创建它。他们应向产品负责人提问: