Qmino（Miredotを作成する会社）では、何百ものREST APIを作成しました。APIを使用する喜びになるまで、設計と再設計を行います。ドキュメントは、APIのユーザーインターフェイスです。それは私たちがしっかりと信じていることです。優れたAPIを実際に披露する唯一の方法は、開発者が楽しむための美しく適切なドキュメントを提供することです。それが、私たちがドキュメンテーションに関して非常に細心の注意を払っている理由です。Javadocがなくてもビルドは失敗し、コードレビューにはドキュメントのチェックが含まれます。それに加えて、REST APIドキュメントで何か問題が検出された場合、Miredotはビルドを失敗させます。Miredot数年前、Java用の優れたREST APIドキュメントツールを見つけることができませんでした。Javadoc、Javaソースコード、注釈などの既存のアーティファクトを必要とするものが必要でした。jax-rs、spring、jacksonなど、使用するフレームワークを理解し、それを美しいものに変えるもの。APIの消費者が使いたいもの。それこそが、Miredotで継続的に目指していることです。そして、これまでのところ、私たちは結果を非常に誇りに思っています！
miredot
ウェブサイト:
http://www.miredot.comカテゴリー
