オンラインドキュメントのspecflow

Question

私は、私の会社（.NET）でいくつかの "実行可能な仕様"アプローチを紹介したいと思います。私はGherkinがすばらしいツールであると本当に確信しているので、SpecFlowを使い続けたいと思います。私は、テストエンジンがこの生きたドキュメンテーションをwikiに投稿して、ビジネスの人々や他のステークホルダーに見えるようにしたいと思います。シナリオにいくつかのコメントを追加して、できるだけユーザーフレンドリーにすることができるようにすることをお勧めします。

これはどのように管理しますか？私は聞いたFitnesseまたはストーリーテラーしかし、彼らはガーキンを扱っていないようです。私が間違っている ？

Answer 1

Picklesをご覧ください。 Picklesは、あなたの.featureファイルをHTMLページ（またはWordまたはExcelドキュメント）に変換する、生き生きとしたドキュメント生成プログラムです。これらのhtmlページは、内部Webサーバーでホストできます。

「コメントを追加」とは何を意味するのかよく分かりません。

• あなたが意味する場合
  は、「生きているドキュメントをいくつかのコメントを追加」：あなたはもちろん、htmlファイルを編集することができますが、あなたは生きているドキュメントを再生成する場合、それらの変更は失われます。これらの変更は.featureファイルにも送信されません。
• 「ドキュメントの読者が特定の/ when/stepsよりも多くの情報を持つようにいくつかのコメントを追加する」とは、Gherkinでは、フィーチャーファイルの先頭と各シナリオGherkinでは、行頭に＃を付けて技術的なコメントを書くこともできます。 Picklesは常に説明をレンダリングし（マークダウンはサポートされています）、必要に応じてテクニカルコメントを表示します。

完全開示：私はピクルスのメンテナーです。ピクルスを始める際に助けが必要な場合は、お気軽にお問い合わせください！