きゅうりのシナリオから、エンド ユーザー (潜在的にはオンライン、潜在的には印刷) のヘルプ/ドキュメントを作成しようとした人はいますか? または、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
ドキュメントへの翻訳:
リンクを追加する場合は、ブログ投稿の編集ページに移動します。「リンクを追加」ボタンを押して、「http://stackoverflow.com」などの URL をリンク URL フィールドに入力します。「OK」をクリックします。
1 つは Cucumber の機能をドキュメントに解析するための何かを書き、2 つは優れたドキュメントを作成するような方法で Cucumber の機能を記述/構造化することです。結果として生じるドキュメンテーションは、構造に大きな変化がなければ、本当に退屈に聞こえるでしょうか?
このアイデアのようなものは他にありますか?doxygenは、エンドユーザー向けのドキュメントというよりも、コードのドキュメント向けのようです。
スクリーンショットを自動的に撮るのはどうですか?これはより実り多い道のように思えます.RSpecテストが失敗したときにスクリーンショットを撮るコードを再利用し、所定の状況でスクリーンショットを撮るようにしてください. これを行うより良い方法はありますか?