带有在线文档的 specflow

specflow with online documentation

我想在我的公司 (.NET) 中介绍一些 "executable specifications" 方法。我想保留 运行 SpecFlow,因为我真的相信 Gherkin 是一个很棒的工具。我希望测试引擎能够 post wiki 上的此动态文档,以使其对业务人员和其他利益相关者可见。一个好的选择应该是能够为场景添加一些评论,以尽可能保持用户友好。

您将如何处理?我听说过 FitnesseStoryTeller,但他们似乎不处理小黄瓜。我错了吗?

您可能想看看 Pickles。 Pickles 是一个实时文档生成器,可以将您的 .feature 文件转换为 html 页(或 Word 或 Excel 文档)。您可以在内部网络服务器上托管这些 html 页面。

我不确定你说的 "add some comments" 是什么意思。

  • 如果您的意思是 "add some comments to the living documentation":您当然可以编辑 html 文件,但是当您重新生成活动文档时,这些更改将会丢失。这些更改也不会发送到 .feature 文件。
  • 如果您的意思是"add some comments so that the readers of the documentation have more information than just the given/when/then steps":Gherkin 允许您在功能文件的开头和每个场景的开头编写描述。 Gherkin 还允许您在行前加上# 来编写技术评论。 Pickles 将始终呈现描述(支持降价!)并可选择呈现技术评论。

完全披露:我是 Pickles 的维护者。如果您需要帮助开始使用 Pickles,请随时提出!