Fitnesseテストのフィクスチャのドキュメントを生成する方法

Question

私は数年間、Fitnesseを使用しているプロジェクトで作業しています。重要なトピックの1つは、メンテナンスと新しいテストの追加です。重複を避けるには、既存のfixturesのドキュメントを用意することをお勧めします。 C#またはC++コードからfixturesのドキュメントを生成するツールがありますか？

Answer 1

私は主にJavaで動作し、JavaDoc（xmldocに相当）に基づいてそのフィクスチャのドキュメントを生成したチームに遭遇しました。彼らは独自のソースポストプロセッサを作成し、各フィクスチャを記述するwikiページとこれらのコメントに基づいた各メソッドを生成しました。 .Net環境用に類似のものを作成することができます（まだ存在しない場合）。

私の個人的な経験は、フィクスチャのドキュメントを書くことは、私のコードでコメントで達成できるものを超えているということです。私のオープンソースライブラリの主要なフィクスチャごとに、すべてのメソッド（定義されたドメイン固有の言語）をリストした概要ページを作成しました。その下で、実際のフィクスチャを示す複数のサンプルテストページを追加しました。さらに私は、ドキュメント（種類の）も提供するフィクスチャのFitNesse受け入れテストを作成します。これはすべて手作業で、私は人々が施設から恩恵を受けることが重要であると信じています。

ジェネレータをセットアップして正しい入力が確実にフィクスチャのコードに表示されるようにするよりも、マニュアルを手作業で書いて時間を費やすほうが良いと思います。ちょうど2ctsです。