使用Cucumber或RSpec + Selenium创建最终用户文档？

Question

有没有人尝试在黄瓜情景中创建最终用户(可能在线,可能被打印)帮助/文档？或者使用RSpec和Selenium RC这样做的截图用于文档？

对于Cucumber,我想象的是:

Scenario: If you want to add a link
Given I am on the edit blog post page
When I press the "add link" button
And I type in a link URL "http://stackoverflow.com"
And I click "OK"
Then the blog post should have 1 link

翻译到文档:

如果要添加链接,请转到编辑博客帖子页面.按"添加链接"按钮,在链接URL字段中键入URL,如" http://stackoverflow.com ".单击"确定".

是否值得我花时间尝试,为此,写一些东西来解析我的Cucumber功能到文档,还有两个,编写/构建我的Cucumber功能,以创建良好的文档？如果结构没有太大的变化,最终的文档听起来真的很无聊吗？

还有其他任何想法吗？对于代码文档而言,doxygen看起来比最终用户文档更多.

如何自动截取屏幕截图？这似乎是一个更富有成效的路径 - 只需重用在RSpec测试失败时获取屏幕截图的代码,并在规定的情况下使用它.有一个更好的方法吗？

Answer 1

您应该看看黄瓜屏幕截图宝石。看起来它完全符合您的要求——为场景中的每个步骤获取 HTML 或（如果您使用的是 Mac）PNG 屏幕截图。（去年我一直在尝试这个想法的我自己的版本。我很早就放弃了它，所以你可能最好使用黄瓜屏幕截图，但也可以随意从 Visible Cukes 获取任何你可以使用的东西） 。