ちなみに、clayプラグインだと定義ダイアログでコメントを残せるのですが、
そのコメントがXMLに書き込まれます。
なので、そのXMLをXSLT変換してドキュメント化しています。

diconファイル用のXSLTを用意しようかなと思っているのですが、
これがあれば、設定ファイルがブラウザで見えるんですよね。
ブラウザ用に説明文章も混ぜたいので、
diconファイルにコメントを要素・属性として入れれるようにしてくれると
ありがたいなと思います。

<component ..... comment="XXX用の業務ロジックです。">
<property name="hoge" comment="暫定。差し替え予定有り">.....</property>
</component>
見たいな感じ。