Webアプリケーションの複雑な相互依存コントロールを文書化するにはどうすればよいですか？

Question

私のような複数の相互依存関係を持つダース・コントロールとのインタフェース報告Webアプリケーション持っている：複数のキャンペーンまたは「すべてが」のキャンペーンのために選択されているならば、キャンペーンをフィルタすることにより、グループにする必要があります

• を
• それは、チェックボックス「セカンダリ出版社を含める」を追加、製品Xビューだとセカンダリ出版社のオプションは、このクライアントのために割り当てられている場合。
• チェックされている「セカンダリ出版社を含める」なら、そこおそらく百このようなルールに近く、私のコードはかなり複雑得ている

フィルタによってグループにセカンダリパブリッシャを追加します。大きな書き直しを行う前に、依存関係を文書化して、より適切な自動テストを実施できるようにしたいと思います。

なドキュメンテーションのためのベスト・プラクティスに向けた任意のポインタ？

私がここにいる間に、コードの複雑さを管理するための任意のポインタ？

Answer 1

たぶんない正しい答え（私はそれは、多かれ少なかれ、この種の状況のた​​めに構築されたと思われるので、....、knockout.jsを使用して考えています）、しかし：行くし、それらの自動テスト自体を書きます。彼らは実行可能なドキュメントとして機能します。あなたが同じスタイルでそれらを書いて短くしておくと、ある程度人間が読めるようにすることさえできます。