【问题标题】:Specific examples of Agile documentation? [closed]敏捷文档的具体例子? [关闭]
【发布时间】:2009-02-10 20:20:42
【问题描述】:

在回答问题 Documents for a project? 时,Chris Ballance 回复说"User Stories" and a "burndown chart" are the two most useful types of project documentation for a developer.

我的问题是,您是否知道任何我可以看到(例如在互联网上或在书中)的此类文档的好示例?

如果可能的话,我很乐意看到很多例子,包括:

  • 小/短/简单示例
  • 大/长/复杂的例子
  • 著名的例子
  • 高质量示例

我觉得这对 Google 来说不是一个简单的话题:我发现很多关于它的文章,但展示它的演示较少。

【问题讨论】:

    标签: documentation agile user-stories burndowncharts


    【解决方案1】:

    就书籍而言,一个非常好的起点是 User Stories AppliedAgile Estimation and Planning,两者都是 Mike Cohn 的。对于任何第一次接触敏捷方法的人来说,这都有很好的例子和很好的起点。

    就网站资源而言,它们很少而且相差甚远。实际开始的一个好地方可能是在 Google 图片上搜索这些关键字,因为许多人会为他们的燃尽图和用户故事拍照。这对我开始时帮助很大。以下是一些示例:Burndown ChartUser Stories

    但是请注意,虽然燃尽图是一个简单的报告,您可以根据迭代中留下的当前故事点运行,但用户故事比这更复杂,并且确实需要一些阅读才能理解。从用户故事应用书开始。

    希望有帮助!

    【讨论】:

    • 我很惊讶地听到“网站资源很少而且相距甚远”:这些类型的文档是否没有在实践中使用,然后由“虚拟团队”(即地理上分散的开发人员)开发开源(即公开可用的)项目?如果不是,你能推测一下为什么不吗?
    • 我实际上在一个远程敏捷团队工作,当然我们使用远程工具,我认为您的意思是从学习敏捷的一个方面。对于虚拟工具,您有 Acunote、TargetProcess、Unfuddle 等选项。这些工具对远程团队很有用,但不应尽可能取代软木板。
    • 所以我认为您是说用户故事等虚拟团队使用;但是,它们往往不在网站上,因为它们是使用工具(如您引用的工具)而不是网络来创作的?
    • 或者,是否更多地与封闭/专有和开放/公共开发项目之间的区别有关:即它们在网站上,而不是在 public 网站上?
    • 我想说,在我们的团队中,我们确实有用户故事,但是很容易让它们变得太大而错过重点。将用户故事放在索引卡上的部分原因是您不能让用户故事太大。
    【解决方案2】:

    我认为对于这两个问题,您可以做的比浏览 Alistair Cockburn 的网站要糟糕得多。特别是,他有一篇关于燃尽图以及生成它们的不同方法的精彩文章:

    http://alistair.cockburn.us/Earned-value+and+burn+charts

    (尽管我赞同之前发布者对 Mike Cohn 作品的推荐)。

    其中一个技巧是确定哪种文档适合您的项目。您是否有很多开发人员,分布在时间和空间上?您将需要更大、更重、更详细的故事。您是否有一两个开发人员在同一个地方工作?你可以摆脱较轻的。团队是否在系统中工作了很长时间(如果它是遗留系统)?轻松的故事可能会。团队是系统新手,还是其业务需求复杂?这会将您推向更详细的方向。

    如果您按照十几个小定义中的任何一个进行“小”项目,那么您可能会接受非常轻松的故事。下面是一个来自 Cockburn 网站的示例:

    http://alistair.cockburn.us/Examples+of+ultra-light+use+cases

    【讨论】:

      【解决方案3】:

      几个月前,我们在开发功能的同时开始编写用户文档。每个 Scrum 团队都分配了一名技术作家。

      在开发过程中必须编写用户文档有助于验证设计。技术作家也参与了应用程序的设计。

      这是对发布燃尽和冲刺燃尽的补充。

      当团队认为与产品负责人沟通有用时,他们会创建其他文档。随着我们正在学习编写更好的用户故事,这变得不那么重要了。

      【讨论】:

      • 我一直认为功能规范是最有用的文档。用户文档是功能规范 IMO 的子类。因此,如果您说用户文档已经足够,并且在软件之前和/或与软件一起开发它是好的,我认为这是有道理的。
      • 实际上,用户文档对于开发人员来说可能已经足够了(“我们正在构建什么最终用户功能?”),但对于项目经理来说可能不够用(“在这个 sprint 中做了什么 ,相反,哪些较低优先级的功能被分类并至少在下次之前被忽略?”)。
      【解决方案4】:

      考虑阅读 Ambler 的“敏捷建模”。他提出了一个非常有力的案例,说明为什么只创建大量完整的 UML 是一个相当糟糕的主意,并给出了一些很好的例子。

      【讨论】:

      • 仅仅解释为什么不创建大量 UML 并不能回答我的问题。
      • 对不起,我没有时间写更完整的东西,主要是想让你看看这本书。他确实讨论了他的用例替代方案以及捕获的重要内容。
      猜你喜欢
      • 1970-01-01
      • 1970-01-01
      • 2013-12-06
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      相关资源
      最近更新 更多