|
テンプレートデザイナのためのツールドキュメントを提供することを重要視していますした。
これを実現するために、テンプレートデザイナに関係する全ての情報を網羅するドキュメント形式が定義されました。
これは、通常の Javadoc に加えて提供されます。
これによって、私たちがいつも Velocity に求めている事−
"テンプレートデザイナの仕事とソフトウェア開発者の仕事を分離せよ"
−を達成する手助けになるはずです。
新しいドキュメント形式については、Struts の
MessageTool
が良い例となっています。
更新情報:
この形式の見栄えと可読性を重宝すると同時に、
私たちは現在その使用から遠のいています。
一番の理由は、開発者にとってメンテナンスしにくいからです。
(i.e. 誰も余分な作業をするほどの意欲がないのです。)
もしこの形式に価値があると判断し、様々なツールのドキュメントを作成し、
メンテナンスしたいと思いましたら、参加するための詳細について
下記 を参照して下さい。
当面は、各々のツールのjavadocの改善と、
サブプロジェクトのドキュメントの見直しを努力します。
|