MicroProfile OpenAPIによるAPI管理(Part2):MicroProfile OpenAPI annotationを利用しドキュメント化する 富士通技術者ブログ~Javaミドルウェア~ 2020年5月15日 初版 数村 憲治 コードとドキュメントの不一致問題 新しくコードを作成する際には、ドキュメントを作ることは多いですが、コードを修正する際に必ずしも毎回ドキュメントが更新されず、いつのまにか、コードとドキュメントが乖離しているということになっていないでしょうか?これは、マイクロサービスに限った話しではなく昔からある問題ですが、対応方法についても昔からいろいろ考えられてきました。その中で、現在もっとも成功しているやり方の一つとしてJavadocがあります。 JavadocはJavaソースのコメント中にタグを使って、クラス、メソッド、変数などの情報を記載し、javadoc