带有在线文档的规范流

Question

我想在我的公司 (.NET) 中介绍一些“可执行规范”方法。我想继续使用 SpecFlow，因为我坚信 Gherkin 是一个很棒的工具。我希望测试引擎能够在 wiki 上发布此动态文档，以使其对业务人员和其他利益相关者可见。一个不错的选择应该是能够向场景中添加一些 cmets，以尽可能保持用户友好。

您将如何处理这个问题？我听说过 Fitnesse 或 StoryTeller，但似乎他们不处理 Gherkin。我错了吗？

Answer 1

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

我不确定您所说的“添加一些 cmets”是什么意思。

• 如果您的意思是“将一些 cmets 添加到活动文档中”：您当然可以编辑 html 文件，但是当您重新生成活动文档时，这些更改将会丢失。这些更改也不会发送到 .feature 文件。
• 如果您的意思是“添加一些 cmets，以便文档的读者获得比给定/何时/然后步骤更多的信息”：Gherkin 允许您在功能文件的开头和开头编写描述每个场景。 Gherkin 还允许您通过在行前加上 # 来编写技术 cmets。 Pickles 将始终呈现描述（支持降价！）并可选地呈现技术 cmets。

完全披露：我是 Pickles 的维护者。如果您在开始使用 Pickles 时需要帮助，请随时提问！