2010-05-05 31 views
10

有没有人试图在您的黄瓜场景中创建最终用户(可能在线,可能要打印)帮助/文档?或者在使用RSpec和Selenium RC的文档中使用屏幕截图进行操作?使用Cucumber或RSpec + Selenium创建最终用户文档?

黄瓜,我想象类似:

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”。点击“确定”。

难道是值得我的时间,试图为一体,写点东西来分析我的黄瓜功能集成到文档和两个写/我的结构特点黄瓜以这样的方式创造了良好的文档?结果文档最终会听起来很枯燥,没有太多的结构变化?

有没有像这个想法一样的东西?对于代码文档,Doxygen看起来更像是最终用户文档。

自动截取截图怎么样?这似乎是一条更加富有成效的路径 - 只需重新使用RSpec测试失败时截取屏幕截图的代码,并在规定的情况下使用它即可。有一个更好的方法吗?

回答

3

你应该看看cucumber-screenshot宝石。它看起来就像你想要的一样 - 在你的场景中采用HTML或者(如果你在Mac上)PNG截图。 (我在去年玩my own version of this idea一段时间,我很早就放弃了它,所以你最好用黄瓜屏幕截图,但可以随意采取任何你可以从可见Cu中使用的东西)。

0

听起来很酷。也许你不想要一些黄瓜方案可用于整个世界。如果开发者放置了敏感的东西,比如人名/开发密码;或者发现了一个网站漏洞,并编写了一个黄瓜场景来验证它是否被修补。

3

我使用Lowdown(http://lowdownapp.com)与客户端来回交流功能。黄瓜的重点在于它是业务特定的,所以你不应该把它翻译成另一种格式的文档。不过,我看到你要去哪里。

您可以使用http://seleniumshots.com/从测试中获取您应用的屏幕截图。不过,我不知道它是否还没有公测。