コントラクト ファーストの Web サービスを開発しており、適切なドキュメントをスキーマに含めて、できるだけ自己記述的にしたいと考えています。
JAXB がそれらを取得し、生成された Java ファイルに Javadoc として含めるように、XSD 注釈とドキュメントを配置するためのベスト プラクティスは何ですか? 一部の要素と列挙がドキュメントを取得することに気付きましたが、一部はそうではありません。各クラス、要素、またはメソッドを記述するために、各要素、複合型定義、または WSDL 操作の後に配置する必要がある特定の場所はありますか?